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在 这 一 章 中 ， 我 们 会 回答 这 样 一 些 基 本 的 问题 : wxWidgets 是 什么 ， 它 和 别 的 类 似 的 开发 库 有 
什么 不 同 。 我 们 还 会 大 概 说 一 下 这 个 项 目的 历史 ， 以 及 wxWidgets 社 区 的 工作 ， 它 采用 的 许可 
协议 ， 它 的 体系 架构 以 及 目前 拥有 的 各 种 版 本 等 。 


什么 是 wxWidgets 


wxWidgets 是 一 个 程序 员 的 开发 工具 包 ， 这 个 工具 包 用 来 开发 用 于 桌面 或 者 移动 设备 的 图 形 界 
面 应 用 程序 。 或 者 说 它 提 供 了 一 个 框架 ， 它 作 了 很 多 底层 的 管家 婆 似 的 工作 以 便 给 应 用 程序 
提供 一 些 默 认 的 行为 。wxWidgets 库 给 程序 员 提 供 了 大 量 的 类 以 及 类 的 方法 ， 以 供 其 使 用 和 定 
制 。 一 个 典型 图 形 界 面 应 用 程序 所 作 的 事情 包括 : 显示 一 个 包含 各 种 标准 控件 的 窗口 ， 也 可 
能 需要 在 窗口 中 绘制 某 种 特别 的 图 形 或 者 图 像 ， 并 且 还 要 响应 来 自 鼠 标 ， 键 瘟 以 及 其 它 输入 
设备 的 输入 。 很 可 能 这 个 点 用 程序 还 要 和 其 它 的 进程 通信 ， 甚 至 还 要 驱动 别 的 应 用 程序 ， 换 
句 话 说 ，wxWidgets 可 以 让 程序 员 编 写 一 个 拥有 所 有 通用 特性 的 时 噜 点 用 程序 的 工作 变 的 相对 
容易 。 


虽然 wxWidgets 经 常 被 打上 图 形 界面 程序 开发 的 标签 ， 但 是 它 在 很 多 其 它 的 应 用 程序 开发 方面 
也 提供 了 很 多 特性 支持 。 这 样 作 的 目的 是 为 了 让 使 用 wxWidgets 编 写 的 程序 的 各 个 部 分 都 可 以 
是 跨 平台 的 ， 而 不 仅仅 是 图 形 界面 的 部 分 。 这 些 部 分 包括 : 文件 和 流 操 作 ， 多 线程 ， 程 序 设 
E, RA, EAE, BRASS. 


1.1 为 什么 要 使 用 wxWidgets? 


wxWidgets 和 其 它 类 似 的 GUI (ABA PAH, FA) 库 比 如 MFC 或 者 OWL 一 个 最 本 质 的 区 
别 在 于 ， 它 是 跨 平台 的 。wxWidgets 提 供 的 API 画 数 在 它 支 持 的 所 有 平台 上 是 想 同 的 或 者 是 非 
常 相似 的 。 这 意味 着 你 可 以 编写 一 个 Windows 上 运行 的 程序 ， 这 个 程序 不 需要 经 过 任何 改动 ， 
或 者 只 需要 很 少 的 改动 (这 种 情况 并 不 常见 ) ， 只 需要 通过 重新 编译 ， 就 可 以 在 Linux 或 者 
Max OSX 上 运行 。 上 比 起 为 另外 的 平台 从 头 编写 代码 ， 这 显然 有 很 大 的 好 处 ， 另 外 一 个 附带 的 
好 处 是 ， 你 不 需要 重新 学 习 那 个 平台 的 APl。 而 且 ， 你 的 程序 可 能 在 将 来 很 长 时 间 仍然 可 以 使 
用 。 因 为 随 着 计算 机 科技 的 演进 ，wxWidgets 将 会 随 之 一 起 演进 ， 这 样 你 的 程序 将 会 很 方便 的 
移植 到 最 新 的 操作 系统 以 支持 最 新 的 特性 。 


另外 一 个 与 众 不 同 的 地 方 在 于 ，wxWidgets 可 以 给 你 的 应 用 程序 提供 本 地 观感 。 一 些 其 它 的 可 
以 跨 平 台 的 开发 框架 在 不 同 的 平台 使 用 同 样 的 窗口 组 件 代 码 〈 译 者 注 : 难 到 他 指 的 是 
JAVA?) ， 也 许 它 会 通过 类 似 窗口 主题 这 样 的 方式 来 模拟 本 地 观感 。 而 wxWidgets 则 尽 可 能 
的 使 用 本 地 的 窗 口 控件 (当然 wxWidgets 也 提供 自己 的 控件 集 ， 这 是 另外 一 个 话题 了 ) ， 所 
以 wxWidgets 的 程序 不 只 是 看 上 去 象 是 本 操作 系统 上 的 原生 程序 ， 它 实 际 上 就 是 原生 程序 。 
对 于 使 用 应 用 程序 的 用 户 来 说 ， 这 是 非常 重要 的 ， 因 为 和 本 地 操作 系统 标准 的 任何 一 点 细微 
的 甚至 是 几乎 难以 察觉 的 不 同 ， 都 会 让 他 们 产生 避 而 远 之 的 想法 。 


让 我 们 来 举例 说 明 。 下 图 演示 了 一 个 叫做 StoryLines 的 小 程序 运行 在 Windows XP 上 的 样子 : 
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正 象 大 家 看 到 的 那样 ， 这 是 一 个 典型 的 Windows 应 用 程序 ， 有 典型 的 Windows 的 GUI 控件 例如 
标签 页 ， 滚 动 条 以 及 下 拉 列 表 。 类 似 了 ， 下 图 演示 了 这 个 程序 在 Max OSX 上 的 样子 ， 正 象 我 
们 期 待 的 那样 ， 它 有 着 水 晶 外 形 图 标 ， 没 有 菜单 条 《因为 按照 荃 果 的 风格 ， 当 前 窗口 的 菜单 

条 应 该 显示 在 屏幕 的 最 顶层。 ) 
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为 什么 不 直接 使 用 JAVA 呢 ? 对 于 基于 Web 的 应 用 来 说 ，JAVA 的 确 很 不 错 ， 但 是 对 于 桌面 应 用 
程序 来 说 ，JAVA 有 时 候 并 不 是 一 个 很 好 的 选择 。 一 般 来 讲 ， 基 于 C++ 的 wxWidgets 程 序 会 运 
行 更 快 ， 感 观 上 更 象 本 地 原生 程序 并 且 更 容易 安装 ， 因 为 它 并 不 依赖 于 你 的 机 器 一 定 要 有 
JAVA 虚拟 机 。C++ 也 更 容易 访问 操作 系统 提供 的 底层 函数 并 且 更 容易 和 已 有 的 C++ 或 者 C 代 
码 集 成 。 基 于 以 上 原因 ， 您 现在 经 常用 到 的 桌面 程序 中 ， 很 少 有 全 部 基于 JAVA 开发 的 。 而 
wxWidgets 则 可 以 让 你 开发 高 性 能 的 ， 本 地 原生 的 应 用 程序 。 而 这 可 能 正 是 你 的 用 户 所 期 待 
的 。 


wxWidgets 是 一 个 开放 源 代码 的 项 目 。 宫 无 疑问， 这 意味 着 使 用 wxWidgets 是 免费 ， 它 不 需要 
额外 花费 你 1 分 钱 〈 除 非 您 愿意 大 方 的 向 这 个 项 目 进 行 捐助 ) ， 但 是 ， 开 放 源 代码 并 不 仅仅 意 
味 着 免费 ， 它 有 着 更 重要 的 意义 。 开 源 项 目 通常 可 以 持续 比 它 的 创建 团队 或 者 通常 意义 上 的 
拥有 者 更 长 久 的 时 间 。 使 用 wxWidgets 开 发 程序 ， 你 的 代码 永远 不 会 过 时 ， 你 的 代码 所 依赖 
的 开发 平台 永远 不 会 消失 。 你 可 以 通过 直接 修改 源 代 码 来 修正 基础 库 中 的 问题 〈 译 者 注 : 使 
用 Delphi 的 开发 者 对 此 可 能 有 更 深 的 体会 ， 由 于 众所周知 的 原因 ， 很 多 开发 工具 慢 慢 的 被 淘汰 
T) 。 你 甚至 可 以 自己 抽 点 时 间 加 入 到 wxWidgets 的 开 发 团队 中 来 ， 维 护 其 中 的 一 部 分 代 
码 ， 这 也 是 一 件 非常 有 趣 的 事情 。 开 源 项 目的 团队 成 员 之 所 以 加 入 某 个 团队 是 因为 他 们 热爱 
他 们 正在 作 的 事情 ， 并 且 人 迫不及待 的 想 把 他 们 的 知识 和 别人 分 享 ， 而 商业 项 目的 客服 支持 人 
员 通 常 不 具有 这 种 理想 主义 的 情节 ， 当 你 使 用 wxWidgets 开 始 编程 时 ， 你 其 实 是 把 自己 放 入 一 
DADAR 证 的 有 艺术 天 赋 的 一 堆 天 才 中 间 GAR : 我 只 是 按照 字面 意思 翻译 ， 虽然 我 自己 
用 wxWidgets 开 发 程序 ， 但 是 这 样 的 话 还 是 让 我 觉 的 有 一 点 点 善意 的 悉 心 。 可 能 是 我 的 英文 
太 差 了 ， 没 有 理解 原 话 的 意思 ， 原 话 是 这 样 的 : When you use wxWidgets, you tap into an 


astonishing talent pool, with contributors from a wide range of backgrounds.) ， 这 些 天 才 来 
自 世 界 的 各 个 角落 ， 有 着 各 种 各 样 的 背景 。 开 发 应 用 程序 需要 考虑 的 很 多 细节 都 被 这 些 天 才 
封装 在 了 你 可 以 直接 拿 来 很 简 单 就 可 以 使 用 的 类 中 ， 如 果 不 是 这 些 天 才 的 劳动 ， 你 可 能 要 花 
费 很 大 的 精力 才能 应 付 。 一 个 开放 和 活路 的 社区 将 会 通过 邮件 列表 对 你 提供 帮助 ， 在 这 里 ， 
你 会 享受 到 讨论 的 乐趣 。 这 些 讨论 并 不 全 是 和 wxWidgets 相 关 的 。 更 多 情形 下 ， 你 是 和 社区 
那些 有 经 验 的 或 者 没有 经 验 的 开发 者 进行 心灵 的 交流 .也 许 有 一 天 ， 你 会 发 现 自己 成 为 
wxWidgets 之 所 以 成 功 的 一 分 子 。 


wxWidgets 已 经 被 广泛 的 应 用 在 各 种 工业 领域 。 它 的 用 户 包 含 了 象 AOL,AMD,CALTECH,， 
Lockheed Martin, NASA, the Open Source Applications Foundation, Xerox 等 等 这 些 大 的 商业 
和 团体 机 构 。wxWidgets 拥 有 很 广泛 的 使 用 者 ， 从 个 体 的 软件 开发 者 到 大 的 商业 团体 ， 从 计算 
机 科学 领域 到 医疗 研究 领域 ， 从 社会 生态 学 到 电信 和 领域。 当然 ， 还 有 数 不 清 的 开源 项 目 在 使 
用 它 ， 例 如 Audacity 声 音 编 辑 项 目 和 pgAdmin 川 数据库 设计 和 维护 项 目 等 。 


人 们 出 于 各 种 各 样 的 目的 而 使 用 wxWidgets, 一 些 人 只 是 把 它 作 为 单 平台 开发 上 MFC 的 优雅 的 
替代 者 ， 一 些 则 是 为 了 让 他 们 的 程序 可 以 方便 的 从 微软 的 Windows 移 植 到 Linux 或 者 是 葵 果 的 
OSX, wxWidgets 还 正 致力 于 移动 终端 的 支持 ， 包 括 艇 入 式 linux， 微 软 的 Pocket PC， 在 不 
久 的 将 来 还 会 支持 Palm OS, 


1.2 wxWidgets 的 历史 


1992 年 ，Julian Smart 在 Edinburgh 大 学 开始 制作 一 个 叫做 Hardy 的 图 表 工 具 的 时 候 ， 为 了 避 

免 其 发 行 版 本 在 Sun 的 工作 站 和 各 种 PC 之 间作 选择 ， 他 决定 使 用 跨 平台 的 编程 框架 。 但 是 当 

时 可 选 的 跨 平台 的 编程 框架 不 多 ， 而 他 的 部 门 也 不 可 能 给 他 很 多 的 预算 ， 所 以 他 只 能 自己 创 

建 一 个 自己 的 跨 平台 编程 框架 。 这 样 ， wxWidgets 1.0 诞 生 了 。 1992 年 9 月 ， 学 校 允 许 他 把 他 
的 wxWidgets 1.0 上 传 到 部 门 的 FTP 服 务 器 ， 因 此 别 的 一 些 开发 者 也 开始 使 用 他 的 代码 。 最 开 
始 的 时 候 ，wxWidgets 是 面向 XView 和 MFC 1.0 的 ， 由 于 Borland C++ 的 适用 者 抱怨 其 对 MFC 
的 依赖 ， 所 以 Julian Smart 用 纯 Win32 的 代码 重 写 了 wxWidgets。 又 因为 XView 很 快 被 Motif 取 

代 ， 很 快 ，Widgets 提 供 了 对 Motif 的 支持 。 


不 久 以 后 ， 一 个 很 小 但 是 却 很 付 有 激情 的 wxWidgets 用 户 社区 成 立 了 并 且 拥 有 了 自己 的 邮件 列 
表 。 大 量 的 新 代码 和 补丁 开始 融入 到 wxWidgets 中 ， 其 中 包括 Markus Holzem 提 供 的 Xt 的 支 
持 。wxWidgets 也 自然 的 拥有 了 越 来 越 多 的 来 自 世界 各 地 的 使 用 者 : 独立 工作 者 ， 学 术 机 构 ， 
政府 机 构 以 及 很 多 企业 用 户 等 ， 他 们 认为 WxWidgets 提 供 的 产品 质量 和 产品 支持 甚至 好 过 他 们 
见 过 的 或 者 用 过 的 其 它 商业 的 产品 。 


1997 年 ， 在 Markus Holzem 的 帮助 下 ， 新 版 的 wxWidgets 2 API 问 世 。 此 时 ，Wolfram Gloger 
建议 应 该 提供 GTK+ 的 支持 。GTK+ 是 被 GNOME 桌 面 系统 采纳 的 一 套 窗口 控件 。 于 是 ， 
Robert Roebling 开 始 领导 GTK 版 本 的 wxWidgets 的 开发 ， 现 在 wxWidgets 的 GTK 版 本 已 经 成 
为 其 在 UNIX/LINUX 下 的 最 主要 的 版 本 。 到 了 1998 年 ，Windows 和 GTK+ 的 版 本 被 合 入 版 本 控 
制 工具 CVS。Vadim Zeitlin 加 入 到 项 目 中 来 帮助 管理 和 维护 如 此 大 量 的 设计 和 代码 ， 同 年 ， 
Stefan Csomor 开 始 着 手 增加 对 Mac OS 的 支持 。 


1999 年 ，Vaclav Slavik 的 令 人 印象 深刻 的 wxHTML 类 和 HTML 帮 助 文件 显示 控件 被 加 入 进来 。 
2000 年 ，SciTech 公 司 开 始 开 发 wxUniversal 版 本 ， 这 个 版 本 提供 属于 wxWidgets 自 己 的 不 依 
赖 于 任何 其 它 图 形 库 的 窗口 控件 ， 以 便 支持 那些 没有 原生 窗口 控件 库 的 操作 系统 。 
wxUniversal 最 初 被 用 于 SciTech 公 司 的 MGL 产 品 ， 这 个 产品 为 图 形 用 户 界 面 提供 了 底层 支 
持 。 

到 了 2002 年 ，Julian Smart 和 Robert Roebling 在 wxUniversal 的 基础 上 提供 了 wxX11 版 本 ， 这 


个 版 本 信 依 赖 于 Unix 和 X11, 因 此 它 几 乎 适用 于 任何 的 类 Unix 环 境 ， 所 以 ， 它 可 以 被 用 在 相当 
底层 的 系统 中 。 


2003 年 ，wxWidgets 开 始 了 对 Windows CE 的 支持 ， 同 年 Robert RoeblingfEGPE#R A stLinux 
平台 上 演示 了 使 用 wxGTK 编 写 的 程序 。 


2004 年 ， 因 为 收 到 微软 的 商标 方面 的 威胁 ，wxWidgets 被 迫 从 它 原来 的 名 字 "wxWindows" 改 
名 。 


同样 是 在 2004 年 ，Stefan Csomor 和 一 大 群 热心 的 参与 者 彻底 的 修改 了 wxMac OSX 版 本 ， 
OSX 版 本 的 功能 和 性 能 都 得 到 了 极 大 的 提升 。 而 David Elliot 领 导 的 小 组 正在 稳步 的 开发 一 个 
基于 Cocoa 的 版 本 ，William Osborne 也 着 手 开发 一 个 可 以 支持 wxWidgets 的 "minimal" 例 子 的 
Palm OS 6 的 版 本 。 2005 年 4 月 ，2.6 版 的 wxWidgets 发 布 了 ， 几 乎 所 有 的 平台 版 本 在 这 个 版 
本 都 有 了 大 幅 的 改进 和 提高 。 


wxWidgets 将 来 的 计划 包括 : 
一 个 包 管 理工 具 ， 使 得 集成 第 三 方 工具 变 得 容易 。 
RAF AY BRA SU SZ He. 
更 好 的 事件 处 理 机 制 |。 


增强 型 控件 支持 : 比如 一 种 捆绑 了 树 形 控件 和 列表 控件 的 控件 。 
wxHTML 2 提供 在 各 种 平台 下 的 完整 的 Web 能 力 支持 。 
STL 标 准 兼 容 

完整 的 Palm OS 支持 


1.3 wxWidgets 社 区 


wxWidgets 社 区 是 非常 活跃 的。 它 拥 有 两 个 邮件 列表 : wx-users (用 于 普通 用 户 ) 和 wx-dev (用 
于 wxWidgets 的 开发 者 ). 一 个 网 站 ， 网 站 上 有 最 新 消息 ,一 些 文章 以 及 和 wxWidgets 有 关 的 链 

接 ， 还 拥有 一 个 "Wiki" 所 谓 "Wiki" 是 一 个 网 页 的 集合 ， 这 些 网 页 可 以 被 任何 人 修改 和 增加 信 

息 .还 有 一 个 论坛 可 以 用 来 就 某 一 话题 发 起 讨论 . 这 些 网 络 资源 的 网 址 列举 在 下 面 : 


e http://www.wxwidgets.org: 这 是 wxWidgets 的 官方 网 站 
e http://lists.wxwidgets.org: WxWidgets 的 邮件 列表 

e http://wiki.wxwidgets.org: wxWidgets 的 Wiki 

e http://www.wxforum.org: wxWidgets 的 论坛 


和 大 多 数 开 放 源 代码 的 项 目 一 样 ，wxWidgets 采 用 CVS 来 进行 代码 的 管理 和 修改 记录 的 跟踪 . 
为 了 保证 开发 的 有 序 进 行 ， 只 有 少数 几 个 开发 者 拥有 对 CVS 库 的 修改 权限 ， 其 它 的 开发 者 可 
以 通过 提交 补丁 和 提交 缺陷 报告 的 方式 参与 开发 ，wxWidgets 目 前 使 用 的 补丁 和 缺陷 管理 系统 
是 由 SourceForge 提 供 的 。CVS 库 主要 有 两 个 分 枝 ， 稳 定 版 分 支 和 开发 分 支 。CVS 的 稳定 版 
分 支 只 人 允许 为 了 修改 缺陷 而 进行 修改 。 新 功能 的 开发 需要 在 开发 分 支 进行 。 稳 定 版 的 版 本 号 
都 是 双 数 的 ， 例 如 2.4.x 等 ， 而 开发 分 支 的 版 本 好 都 是 单数 的 ， 比 如 2.5.x 等 。 对 于 单数 版 本 ， 
使 用 者 最 好 等 待 新 的 稳定 版 本 的 发 布 再 使 用 。 当 然 直 接 从 CVS 下 载 最 新 的 开发 版 本 也 是 可 以 
的 。 


wxWidgets 的 API 的 修改 通常 是 由 开发 者 在 wx-dev 邮 件 列 表 里 讨 论 以 后 决定 的 。 


除了 以 上 这 些 ， 很 多 其 它 的 wxWidget 相 关 的 项 目 都 拥有 他 们 自己 的 社区 。 例 如 wxPython 社 区 
和 wxPerl (参见 附录 E : wxWidgets 的 第 三 方 工具 ) 社区 . 


1.4 wxWidgets 和 面向 对 象 编程 


和 大 多 数 现代 的 GUI 编程 框架 一 样 ，wxWidgets 大 量 使 用 了 面向 对 象 编程 的 概念 。 每 一 个 窗口 
都 是 一 个 C++ 的 对 象 。 这 些 对 象 已 经 被 预 置 了 很 好 的 处 理 机 制 ， 可 以 接收 事件 并 对 事件 作出 相 
应 的 反应 。 用 户 所 看 到 的 ， 就 是 这 个 对 象 的 交互 系统 中 可 视 化 那 一 部 分 。 作 为 一 个 程序 开发 

人 员 ， 你 所 要 作 的 事情 就 是 合理 的 安排 这 些 可 视 的 行为 集 来 让 它们 作出 的 反应 看 上 去 更 合 

理 。wxWidgets 已 经 实现 了 很 多 默认 的 行为 来 让 这 个 工作 变 的 更 容易 。 


当然 ， 面 向 对 象 的 思想 和 GUI 编 程 并 不 是 同时 产生 的 。 但 是 在 20 世 纪 70 年 代 ， 由 Alan Kay 和 
其 它 一 些 人 设计 的 面向 对 象 的 语言 SmallTalk 却 是 GUI 编程 历史 上 的 一 个 重要 的 里 程 碑 。 无 论 
对 于 用 户 界 面 设计 来 说 ， 还 是 对 计算 机 程序 语言 来 说 ， 它 都 是 一 个 创新 。 虽 然 WwxWidgets 使 用 
不 同 的 语言 和 不 同 的 API， 但 是 就 面向 对 象 的 原理 来 说， 本 质 上 都 是 一 样 的 。 


1.5 wxWidgets 的 体系 结构 


下 表 展 示 的 wxWidgets 的 四 层 体 系 结构 : wxVWidgets 公 用 API 层 ， 各 个 平台 发 行 版 ， 用 于 各 个 平 
台 的 API 和 操作 系统 层 。 


wxWidgets 

API 

oe wxMSW wxGTK WXX11 wxMotif wxMac 

Platform l : i 

API Win32 GTK+ Xlib Motif/Lesstif Carbon 
Mac 

Operating Windows/Windows ee OS 9/ 

System CE Unix/Linux Mac 
OS X 


下 面 依次 说 明 目 前 已 有 的 各 个 平台 发 行 版 本 : 
wxMSW 


这 个 版 本 编译 和 运行 在 各 个 版 本 的 微软 的 Windows 操 作 系 统 上 ， 包 括 : 
Windows95,Windows98,WinMe,Windows NTWindows 2000,Windows Xp 以 及 Windows 
2003. 在 linux 平 台 上 ， 这 个 版 本 也 可 以 使 用 Wine 的 库 进 行 编译 ， 并 且 可 以 被 配置 成 在 WinCE 
上 和 运行。 除了 使 用 本 地 原生 窗口 控件 ， 这 个 版 本 也 可 以 配置 成 使 用 wxWidgets 自 己 的 窗口 控 
件 。 


WXGTK 


wxWidgets 的 GTK+ 版 本 可 以 使 用 GTK 的 1.x 或 者 2.x 版 本 ,支持 所 有 可 以 运行 X11 和 GTK 的 类 
Unix 平 台 (比如 : Linux, Solaris, HP-UX, IRIX, FreeBSD, OpenBSD, AIXẸ). 它 也 可 以 运行 在 
那些 有 足够 资源 的 嵌入 式 平台 ， 比 如 GPE Palmtop 环 境 (如 下 图 所 示 ). wxWidgets 的 GTK 版 本 
是 类 Unix 系 统 的 推荐 版 本 . 
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WXX11 


wxWidgets 的 X11 版 本 使 用 了 wxUniversal 的 窗口 控件 集 ， 直 接 运 行 在 Xlib 上 。 这 使 得 它 很 适合 
找 入 式 系 统 , 当 然 它 也 可 以 运行 在 那些 不 喜欢 GTK+ 的 桌面 系统 上 。 它 支持 所 有 可 以 运行 X11 的 
Unix 系 统 ， 当 然 wxX11 并 不 像 wxGTK 那 样 完善 。 下 图 演示 了 Life 程 序 使 用 wxX11 版 本 编译 运行 
在 一 个 iPAQ PDA 的 类 似 Linux/TinyX 环 境 下 的 样子 。 








wxMotif 


这 个 版 本 的 wxWidgets 可 以 在 大 多 数 拥有 Motif, OpenMotif, 或 者 Lesstif 的 Unix 系 统 上 . 既然 连 
Sun 自 己 都 正 准 各 把 它 的 窗口 控件 集 转 向 GNOME 和 GTK+, 对 于 大 多 数 开发 者 来 说 ，Motif 并 不 
一 个 很 可 靠 的 选择 . 


wxMac 


wxMac 是 为 Mac OS 9 (9.1 以 后 的 版 本 ) 和 Mac OS X (10.2.8 以 后 的 版 本 ) 准 各 的 . 如 果 在 Mac 
OS 9 上 编译 ,你 需要 Metrowerks CodeWarrior 的 工具 包 , 如 果 在 Mac OS X 上 编译 , 你 可 以 选择 
Metrowerks CodeWarrior 工 具 包 或 者 苹果 公司 的 工具 包 . 如 果 使 用 茶 果 公司 的 工具 包 ， 你 应 该 
使 用 Xcode 1.5 或 者 更 高 的 版 本 ,或 者 你 可 以 考虑 直接 使 用 命令 行 工具 toolsGCC 3.3 或 者 其 后 续 
的 版 本 . 


wxCocoa 


这 是 一 个 正在 进行 中 的 版 本 , 它 使 用 Mac OS X 的 Cocoa API. 虽然 Carbon 和 Cocoa 的 功能 很 相 
似 ,但 是 这 个 版 本 有 可 能 会 支持 除 Mac 以 外 的 其 它 支持 GNUStep 的 操作 系统 。 


wxWinCE 


Windows CE 版 本 的 wxWidgets 封 装 了 WindowsCE 平 台 上 的 各 种 不 同 的 开发 包 , 包 括 Pocket 
PC 和 Smartphone 等 . 这 个 版 本 包含 在 wxMSW 的 Win32 版 本 中 。 下 面 第 一 副 图 演示 了 Life 程 序 
在 Pocket PC 2003 模 拟 器 上 运行 的 样子 。 第 二 副 图 则 演示 了 wxWidgets 中 的 对 话 框 例子 运行 
在 一 个 拥有 四 个 屏幕 ， 分 辩 率 为 176x220 的 SmartPhone2003 上 的 样子 。wxWidgets 作 了 大 量 
的 用 户 界面 适 配 方面 的 工作 ， 比 如 因为 Smartphone 只 支持 两 个 菜单 按钮 ， 所 以 在 通常 显示 菜 
单 的 地 方 wxWidgets 构 建 了 可 以 折 和 莹 的 菜单 。 尽 管 如 此 ， 一 些 地 方 仍然 需要 依靠 编程 者 使 用 不 
同 的 代码 ， 比 如 应 该 使 用 SetLeftMenu 和 SetRightMenu 函 数 来 代替 直接 在 对 话 框 上 增加 两 个 
确定 和 取消 按钮 。 
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wxPalmOS 


这 个 版 本 是 为 Palm OS 6 准 各 的 。 到 作者 写 这 本 书 的 时 候 为 止 ， 这 个 版 本 还 处 在 很 初级 的 阶 
段 ， 但 是 已 经 可 以 在 Palm OS 6 的 模拟 器 中 运 
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wxOS2 


wxXOS2 是 一 个 由 别人 维 扩 的 用 于 OS/2 或 者 eComStation 的 版 本 (is a Presentation Manager 
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port for OS/2 or eComStation). 


wxMGL 


行 一 个 很 简单 的 小 程序 了 。 参 
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这 个 版 本 使 用 了 SciTech 公 司 的 底层 图 形 库 ,窗口 控件 使 用 的 是 wxUniversal 中 的 版 本 。 
内 部 组 织 
在 内 部 ，wxWidgets 的 代码 大 致 分 为 6 层 : 


1. 通用 代码 被 所 有 的 版 本 使 用 ， 包 括 类 的 数据 结构 ， 运 行 期 类 型 信息 ， 和 一 些 公 共 基 类 比 
如 wxWindowBase 等 ， 这 些 基 类 的 代码 将 被 所 有 它 的 子 类 所 继承 。 

2. 一 般 代码 用 来 实现 独立 于 各 个 平台 的 高 级 窗口 控件 ， 在 某 个 平台 不 具有 某 种 控件 的 时 候 
将 使 用 这 部 分 代码 ， 比 如 wxWizard 和 wxCalendarCtrl。 

3. 通用 组 件 基本 的 窗口 控件 集 ， 这 套 控件 可 以 在 某 个 平台 (比如 X11 或 者 MGL) 不 具有 它 自 
己 的 窗口 控件 的 时 候 使 用 。 

4. 平台 相关 代码 调用 特定 平台 的 API 来 实现 某 个 类 的 代码 。 上 比如 在 wxMSW 中 的 wxTextCtrl 控 
件 的 实现 是 封装 了 Win32 的 edit 控 件 。 

5， 外 来 代码 存放 在 一 个 单独 的 contrib 目 录 中 ， 提 供 一 些 非 必要 但 是 很 有 用 的 类 实现 。 上 比如 
wxStyledTextCtrl 

6. 第 三 方 代 码 不 是 由 wxWidgets 开 发 维护 但 是 被 wxWidgets 使 用 以 提供 一 些 很 重要 的 特性 的 
代码 ， 比 如 JPEG, Zlib, PNG 和 Expat 库 。 


每 一 个 平台 版 本 所 需要 作 的 事情 就 是 提取 它 需 要 的 那些 层 的 代码 ， 然 后 用 它 那 个 平台 的 底层 
的 AP| 来 实现 wxWidgets 的 APl。 


当 你 编译 你 的 代码 的 时 候 ，wxWidgets 怎 么 知道 要 编译 哪 一 个 平台 的 类 呢 ? 当 你 包含 一 个 
wxWidgets 的 头 文件 〈 比 如 wx/textctrl.h〉 的 时 候 , 由 于 使 用 的 不 同 的 宏 定 义 ， 实 际 上 你 包含 的 
是 一 个 特定 平台 的 头 文 件 (wx/mswltextctrl.h)。 然 后 ， 当 你 链接 wxWidgets 的 库 文件 的 时 候 ， 
当然 这 个 库 文 件 也 需要 是 用 同样 的 宏 定义 编译 的 。 你 可 以 同时 拥有 多 套 宏 定义 ， 例 如 你 可 以 
有 调试 版 本 和 发 布 版 本 两 套 宏 定义 。 通 过 这 些 宏 定 义 的 不 同 ， 你 可 以 控制 编译 器 链接 
wxWidgets 的 动态 或 者 是 静态 版 本 ， 也 可 以 禁止 编译 某 个 特定 组 件 ， 或 者 是 决定 你 要 编译 的 是 
Unicode 版 本 还 是 ANSI 版 本 。 为 了 达到 这 个 目的 ， 你 需要 修改 setup.h 或 者 增加 不 同 的 编译 选 
项 ， 这 取决 于 你 的 编译 器 。 有 关 这 些 问 题 更 详细 的 描述 ， 请 参见 附录 A，??? 安 装 
wxWidgets??? 


另外 一 点 提示 是 : 虽然 wxWidgets 封 装 了 本 地 的 平台 相关 的 API， 并 不 意味 着 在 你 的 
wxVWidgets 程 序 中 不 可 以 使 用 这 些 API。 只 是 ， 在 绝 大 多 数 情况 下 ， 你 用 不 着 使 用 这 些 API。 


1.6 许可 协议 


wxWidgets 采 用 的 是 L-GPL 的 许可 协议 外 加 一 个 附加 条 款 。 你 可 以 从 wxWidgets 的 网 站 上 或 者 
wxWidgets 的 分 发 包 的 docs 目 录 里 看 到 这 份 许可 协议 。 这 份 协议 总 体 上 来 说 就 是 : 你 既 可 以 
使 用 wxWidgets 开 发 自由 软件 ， 也 可 以 使 用 它 开发 商业 软件 ， 并 且 不 需要 支付 任何 版 权 费 用 。 
你 既 可 以 动态 链接 wxWidgets 的 运行 期 库 文件 ， 也 可 以 使 用 静态 链接 。 如 果 你 对 wxWidgets 本 
身 进行 了 任何 改动 ， 你 必须 公开 这 一 部 分 的 源 代码 。 而 完全 属于 你 自己 的 那 部 分 代码 或 者 库 
文件 则 不 需要 公开 。 另 外 ， 在 发 布 使 用 wxWidgets 编 写 的 软件 的 时 人 息 ， 你 还 需要 考虑 
wxWidgets 的 一 些 可 选 组 件 自己 的 许可 协议 ， 比 如 PNG 和 JPEG 图 形 库 的 许可 协议 ， 它 们 和 
wxWidgets 的 许可 协议 可 能 并 不 完全 相同 。 


本 书 中 所 有 的 例子 和 源 代码 同样 使 用 wxWidgets 的 许可 协议 。 


第 一 章 小 结 
在 这 一 章 里 ， 我 们 试图 向 你 解释 wxWidgets 是 什么 ， 简 单 的 描述 了 它 的 历史 ， 大 概 支 持 哪些 平 
台 以 及 大 概 说 了 一 下 它 的 内 部 的 组 织 结构 。 


在 下 一 章 "开始 使 用 "里 ， 我 们 会 通过 几 个 例子 来 展示 一 下 用 wxWidgets 编 写 应 用 程序 大 概 是 怎 
样 一 个 样子 。 


第 二 章 开始 使 用 


在 这 一 章 里 ， 我 们 将 使 用 一 个 很 小 的 例子 ， 来 建立 你 对 用 wxWidgets 编 程 的 一 个 大 致 的 印象 。 
FW Ieee Ae ONGC aaa ie AER a ie 人 怎样 创建 主 窗 
口 ， 怎 样 响应 用 户 的 命 伟 。 正 如 wxWidgets 所 追求 的 短小 精 悍 的 哲学 一 样 ， 这 就 是 折 有 这 一 章 
我 们 要 涉及 的 内 容 。 不 过 在 这 之 前 ， 你 可 能 先 要 参考 附录 人 A 来 安装 wxWidgets. 


wxWidgets 跨 平台 GUI 编程 


2.1 一 个 小 例子 
下 图 演示 了 我 们 的 小 例子 在 Windows 上 运行 的 样子 


«a Minimal wxWidgets App 同上 回回 
Eie tp U O 





这 个 小 例子 创建 了 一 个 主 窗 口 ( 是 一 个 wxFrame 类 的 实例 ), 这 个 主 窗口 有 一 个 菜单 条 和 一 个 状 
态 条 。 菜 单条 上 的 菜单 按照 你 的 命令 显示 一 个 关于 窗口 或 者 退出 这 个 小 程序 。 显 然 这 算 不 上 
什么 杀手 级 的 大 程序 ， 但 是 足以 给 你 展示 wxWodgets 的 一 些 基本 原则 ,并 且 让 你 可 以 相信 ， 随 
着 知识 的 慢 慢 积累 ， 有 一 天 你 将 作出 更 复杂 的 (那些 杀手 级 的 ) 程序 ， 
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2.2 应 用 程序 类 


每 一 个 wxWidgets 程 序 都 需要 定义 一 个 wxApp 类 的 子 类 ， 并 且 需 要 并 且 只 能 构造 一 个 这 个 类 的 
实例 ， 这 个 实例 控制 着 整个 程序 的 执行 。 你 的 这 个 继承 自 wxApp 的 子 类 至 少 需 要 定义 一 个 
Onlnit 函 数 ， 当 wxWidgets 准 备 好 运行 你 写 的 代码 的 时 候 ， 它 将 会 调用 这 个 函数 (和 一 个 典型 
的 Win32 程 序 中 的 main 画 数 或 者 WinMain 范 数 类 似 ) 。 


你 定义 这 个 子 类 的 代码 可 能 和 下 面 的 代码 类 似 : 


class MyApp : public wxApp 
{ 


public: 
virtual bool OnInit(); 


在 这 个 Onlnit 函 数 中 ， 你 通常 应 该 创建 至 少 一 个 窗口 ， 对 传 入 的 命令 行 参数 进行 解析 ， 为 应 用 
程序 进行 数据 设置 和 其 它 的 一 些 初始 化 的 操作 .如 果 这 个 图 数 返 回 真 ，wxWidgets 将 开始 事件 
循环 用 来 处理 用 户 输入 并 且 在 必要 的 情况 下 义理 这 些 输 入 。 如 果 Onlnit 函 数 返 回 假 ， 
wxWidgets 将 会 释放 它 内 部 已 经 分 配 的 资源 ， 然 后 结束 整个 程序 的 运行 。 


接 下 来 我 们 看 一 个 最 简单 的 Onlnit 函 数 的 实现 : 


bool MyApp: :OnInit() 

{ 
MyFrame *frame = new MyFrame(wxT("Minimal wxWidgets App")); 
frame->Show(true); 
return true; 


} 


你 可 能 还 会 注意 到 上 面 例子 中 的 wxT 这 个 宏 ， 在 接 下 来 的 例子 中 ， 这 个 宏 还 会 被 频繁 用 到 。 它 
的 作用 是 让 你 的 代码 兼容 Unicode 模 式 。 这 个 宏和 另外 一 个 7T 宏 的 作用 是 完全 一 样 的 。 使 用 这 
个 宏 也 不 会 带 来 运行 期 的 性 能 损失 。 〈 你 可 能 还 会 遇 到 另外 一 个 类 似 的 "()" 标 记 ， 这 个 标记 是 
用 来 告诉 wxWidgets 将 其 中 的 字符 串 翻译 成 其 它 语言 的 版 本 ， 参 见 第 16 章 “编写 国际 化 程 
Fr”) 。 


那么 创建 MyApp 的 实例 的 代码 在 哪里 呢 ? 实际 上 ， 这 是 在 wxWidgets 内 部 实现 的 ， 不 过 你 仍 
然 需要 告诉 wxWidgets 需 要 创建 哪 一 个 App 类 的 实例 ， 所 以 你 还 需要 增加 下 面 的 一 个 安 : 


IMPLEMENT_APP(MyApp) 


如 果 没 有 实现 这 个 类 ，wxWidgets 就 不 知道 怎样 创建 一 个 新 的 应 用 程序 对 象 。 这 个 宏 除 了 上 述 
的 功能 以 外 ， 还 会 检查 编译 应 用 程序 使 用 的 库 文 件 是 否 和 当前 的 库 文件 的 版 本 相 匹 配 ， 如 果 
没有 这 种 检查 ， 由 此 而 产生 的 一 些 运 行 期 的 错误 可 能 很 难 被 查 出 原因 。 


当 wxWidgets 创 建 这 个 MyApp 类 的 实例 的 时 候 ， 会 将 创建 的 结果 赋值 给 一 个 全 局 变量 
wxTheApp. 你 当然 可 以 在 你 的 程序 中 使 用 这 个 变量 ， 但 是 你 可 能 不 得 不 一 通 又 一 表 的 进行 从 
wxXApp 到 MyApp 的 类 型 强制 转换 。 增 加 下 面 的 这 一 行 声 明 以 后 ， 你 就 可 以 调用 wxGetApp() 范 
数 ， 这 个 函数 会 返回 一 个 到 这 个 MyApp 实 例 的 引用 ， 这 样 用 起 来 就 方便 多 了 。 


DECLARE_APP(MyApp) 


一 点 提示 : 


即使 没有 声明 DECLARE_APP, 你 仍然 可 以 不 用 进行 类 型 强制 转化 就 直接 对 wxTheApp 变 量 调 
用 wxApp 的 方法 .这 可 以 避免 在 所 有 的 头 文件 中 包含 MyApp 的 头 文件 ， 对 于 那些 库 文件 而 不 是 
应 用 程序 的 代码 来 说 也 更 有 意义 ， 而 且 还 可 以 缩短 编译 的 时 间 。 


2.3 Frame 窗 口 类 


我 们 来 看 一 看 自 定 义 的 Frame 窗 口 类 MyFrame. 一 个 Frame 窗 口 是 一 个 可 以 容纳 别 的 窗口 的 顶 
级 窗口 ， 通 常 拥有 一 个 标题 栏 和 一 个 菜单 栏 。 下 面 是 我 们 的 例子 中 这 个 类 的 定义 ， 可 以 将 其 
放 在 MyApp 的 定义 之 后 : 


class MyFrame : public wxFrame 


{ 
public: 
MyFrame(const wxString& title); 
void OnQuit(wxCommandEvent& event); 
void OnAbout(wxCommandEvent& event); 
private: 
DECLARE_EVENT_TABLE( ) 
J; 


IDAO XELLA -TAEA a AARE R AACH RAER, 
有 一 个 宏 来 告诉 wxWidgets 这 个 类 想 要 自己 处 理 某 些 事件 。 
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你 也 许 已 经 注意 到 了 ， 事 件 义理 函数 在 MyFrame 类 中 不 是 虚 函 数 。 如 果 不 是 虚 函 数 ， 他 们 是 
怎样 被 调用 的 呢 ? 答案 就 在 下 面 的 事件 表 里 : 


BEGIN_EVENT_TABLE(MyFrame, wxFrame) 
EVT_MENU(wxID_ABOUT, MyFrame: :OnAbout ) 
EVT_MENU(wxID_EXIT, MyFrame::OnQuit) 

END_EVENT_TABLE( ) 


Fine A, Rahs RIGA (op HAR, BARBIER s 


前 面 展 示 的 事件 表 表 明 ， 要 把 鼠标 点 击 标识 分 别 为 WxID_EXIT 和 wxID_ABOUT 的 菜单 项 的 事 
件 和 MyFrame 的 成 员 画 数 OnAbout 和 OnQuit 关 联 起 来 。 这 里 的 EVT_MENU 宏 上 
件 宏 的 其 中 之 一 ， 事 件 宏 的 作用 是 告 PW ANNI OS HT Te EVE TR A KR 
的 两 个 标识 wxID_ABOUT 和 wxID_EXIT 是 wxWidgets 预 定义 的 宏 ， 通 常 你 应 该 通过 枚 举 ， 
量 或 者 预 编译 宏 的 方式 定义 你 自己 的 标识 。 


用 上 面 的 方法 定义 的 时 间 表 是 一 种 静态 的 事件 表 ， 它 不 可 以 在 运行 期 改变 ， 在 下 一 章 里 ， 我 
们 将 描述 怎样 定义 可 以 在 运行 期 改变 的 动态 事件 表 。 


现在 ， 让 我 们 来 看 看 这 两 个 事件 处 理 范 数 . 


void MyFrame: :OnAbout(wxCommandEvent& event) 


wxString msg; 
msg.Printf(wxT("Hello and welcome to %s"), 
wxVERSION_STRING) ; 
wxMessageBox(msg, wxT("About Minimal"), 
wxOK | wxICON_INFORMATION, this); 


void MyFrame: :OnQuit (wxCommandEvent& event) 


Close(); 


4A PR ERFRS AA, MyFrame::OnAbouthA#H—-SHBE. x ABT 
wxWidgets 提 供 的 APl wxMessageBox, 它 的 四 个 参数 分 别 代 表 消 息 内 容 ， 标 题 ， 窗 口 类 型 以 
及 父 窗口 


当 用 户 点 击 退 出 菜单 项 的 时 候 ，MyFrame::OnQuit 函 数 被 调用 (你 已 经 意识 到 了 ， 这 是 事件 
表 的 功劳 ) 。 它 调用 wxFrame 类 的 Close 男 数 来 释放 frame 窗 口 。 因 为 没有 别 的 窗口 存在 了 
这 触发 了 应 用 程序 的 退出 ， 实 际 上 ，wxFrame 类 的 Close 函 数 并 不 直接 关闭 frame 窗 口 ， 而 是 


产生 一 个 wxEVT_CLOSE_WINDOW 事 件 ， 这 个 事件 默认 的 久 理 画 数 调 用 wxWindow::Destroy 
函数 释放 了 frame 窗 口 。 


用 户 还 可 以 通过 别 的 方法 关 掉 应 用 程序 ， 比 如 通过 点 击 标题 栏 上 的 关闭 按钮 或 者 是 通过 系统 
菜单 中 的 关闭 菜单 ， 在 这 种 情况 下 ，OnQuit 函 数 是 怎样 被 调用 的 呢 ? 事实 上 ， 在 这 种 情况 ， 
OnQuit 函 数 并 没有 被 调用 。 这 时 ，wxWidgets 会 通过 Close 男 数 ( 象 OnQuit 中 的 那样 ) ， 给 
frame 窗 口 发 送 一 个 wxEVT_CLOSE_WINDOW 事 件 ， 这 个 事件 默认 的 处 理 画 数 会 释放 掉 
frame 窗 口 。 在 你 的 应 用 程序 中 ， 可 以 通过 重 载 这 个 义理 函数 来 增加 改变 这 种 默认 的 行为 ， 比 
如 : 如 果 你 想 问 一 问 你 的 用 户 是 不 是 真 的 要 关闭 窗口 。 关 于 这 种 处 理 的 细节 ， 可 以 参见 第 4 
章 ," 窗 口 基础 "。 


另外 ， 大 多 数 的 应 用 程序 类 还 应 该 重 载 一 个 OnExit 函 数 ， 以 便 在 任何 时 候 程 序 退出 时 ， 执 行 


一 下 清理 和 资源 回收 的 动作 。 需 要 注意 的 是 ， 这 个 图 数 只 有 在 OnInit 琅 数 返回 真 的 时 候 才 会 被 
执行 。 当 然 ， 我 们 这 个 小 例子 程序 就 用 不 着 定义 这 个 图 数 了 。 


2.5 Frame A ORY Mie NA 


min, iki Ke arrameBOMHiawA, EEE RN, SfameBONMAt, EARI AS 
如 
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#include "mondrian.xpm" 


MyFrame: :MyFrame(const wxString& title) 
: wxFrame(NULL, wxID_ANY, title) 
{ 


SetIcon(wxIcon(mondrian_xpm)); 

wxMenu *fileMenu = new wxMenu; 

wxMenu *helpMenu = new wxMenu; 

helpMenu->Append(wxID_ABOUT, wxT("&About...\tFi"), 
wxT("Show about dialog")); 

fileMenu->Append(wxID_EXIT, wxT("E&xit\tAlt-X"), 
wxT("Quit this program")); 

wxMenuBar *menuBar = new wxMenuBar(); 

menuBar ->Append(fileMenu, wxT("&File")); 

menuBar ->Append(helpMenu, wxT("&Help")); 

SetMenuBar (menuBar ) ; 

CreateStatusBar(2); 

SetStatusText(wxT("Welcome to wxWidgets!")); 


个 构造 画 数 首先 调用 它 的 基 类 (wxFrame) MWishR, HANSNERAO(RRARA 
口 ， 所 以 用 NULL), 窗 口 标识 (wxID_ANY 标 识 让 WxXWidgets 自 己 选择 一 个 ) 和 标题 。 这 个 基 类 的 
构造 画 数 才 真 正 创 建 了 一 个 窗口 的 实例 。 除 了 这 样 的 调用 方法 ， eee 
is HASH WAS RRA MS, Alia AwxFrame::Create A 6) — 
frame 窗 口 的 实例 。 


小 图 片 或 者 是 图 标 在 所 有 的 平台 上 都 可 以 用 XPM 格 式 来 表示 。XPM 文 件 其 实 是 一 个 ASCII 编 

码 的 完全 符合 C++ 语 法 的 文本 文件 ， 所 以 可 以 直接 用 C++ 的 方式 包含 到 代码 中 ( 译 者 注 : 显然 
这 样 的 包含 方式 在 分 发 软件 的 时 候 是 不 需要 分 发 这 个 图 片 文 件 的 ) 。Setlcon 那 一 行 代码 使 用 
mondrian_xpm 变 量 在 堆栈 上 创建 了 一 个 图 标 ( 这 个 mondrian 变 量 是 在 mondrian.xpm 文 件 里 

定义 的 ) 。 然 后 将 这 个 图 标 和 frame 窗 口 关 联 在 一 起 。 


a+ 


接 下 来 创建 了 菜单 条 。 增 加 菜单 项 的 Append 画 数 的 三 个 参数 的 意义 分 别 为 : 菜单 项 标识 ， 菜 
单 上 的 文本 以 及 一 个 称 微 长 一 些 的 帮助 字符 串 。 这 个 帮助 字符 串 会 自动 在 菜单 项 被 高 亮 显示 
的 时 候 自动 显示 在 状态 栏 上 。 菜 单 上 的 文本 中 由 "&" 符 号 前 导 的 字符 将 成 为 菜单 的 快捷 操作 
符 ， 在 实际 的 显示 中 用 下 划 线 表示 。 而 "\t 符 号 则 前 导 一 个 全 局 的 快捷 键 ， 这 个 快捷 键 甚至 可 
以 在 菜单 项 没有 显示 的 时 候 触发 菜单 功能 。 


这 个 构造 琅 数 所 做 的 最 后 一 件 事 是 创建 一 个 由 两 个 区 域 组 成 的 状态 条 并 且 在 状态 条 的 第 一 个 
区 域 守 上 欢迎 的 字样 。 


2.6 完整 的 例子 


现在 是 时 候 把 所 有 的 代码 放 在 一 起 了 ， 通 常 ， 我 们 应 该 把 头 文件 和 实现 文件 分 开 ， 但 是 对 于 
这 样 小 的 一 个 程序 ， 就 没有 这 个 必要 了 。 


// Name: minimal.cpp 
// Purpose: Minimal wxWidgets sample 
// Author: Julian Smart 


#include "wx/wx.h" 


// 定义 应 用 程序 类 
class MyApp : public wxApp 


public: 
// 这 个 函数 将 会 在 程序 启动 的 时 候 被 调用 
virtual bool OnInit(); 

}; 


// 定义 主 窗口 类 
class MyFrame : public wxFrame 


{ 

public: 
// BORN HERR 
MyFrame(const wxString& title); 


// 334 xe FBR RK 
void OnQuit (wxCommandEvent& event); 
void OnAbout (wxCommandEvent& event); 


private: 
// 声明 事件 表 
DECLARE_EVENT_TABLE( ) 


ten 


// 有 了 这 一 行 就 可 以 使 用 MyApp& wxGetApp() 
DECLARE_APP(MyApp) 


// 告诉 wxWidgets 主 应 用 程序 是 哪个 类 
IMPLEMENT_APP(MyApp) 


// 初始 化 程序 
bool MyApp: :OnInit() 


// 创建 主 窗口 
MyFrame *frame = new MyFrame(wxT("Minimal wxWidgets App")); 


// 显示 主 窗口 
frame->Show(true); 


// 开始 事件 处 理 循环 
return true; 


} 


// MyFrame 类 的 事件 表 
BEGIN_EVENT_TABLE(MyFrame, wxFrame) 
EVT_MENU(wxID_ABOUT, MyFrame: :OnAbout ) 
EVT_MENU(wxID_EXIT, MyFrame::OnQuit) 
END_EVENT_TABLE( ) 


void MyFrame: :OnAbout (wxCommandEvent& event) 


{ 
wxString msg; 
msg.Printf(wxT("Hello and welcome to %s"), 


wxVERSION_STRING); 


wxMessageBox(msg, wxT("About Minimal"), 
wxOK | wxICON_INFORMATION, this); 


} 

void MyFrame: :OnQUit(wxCommandEvent& event) 
// 释放 主 窗口 
Close(); 


#include "mondrian.xpm" 


MyFrame: :MyFrame(const wxString& title) 
: wxFrame(NULL, wxID_ANY, title) 
{ 


// 设置 窗口 图 标 
SetIcon(wxIcon(mondrian_xpm) ); 


// 创建 菜单 条 
wxMenu *fileMenu = new wxMenu; 


// 添加 “关于 ”菜单 项 

wxMenu *helpMenu = new wxMenu; 

helpMenu->Append(wxID_ABOUT, wxT("&About...\tFi"), 
wxT( "Show about dialog")); 


fileMenu->Append(wxID_EXIT, wxT("E&xit\tAlt-X"), 
wxT("Quit this program") ); 


// 将 菜单 项 添加 到 菜单 条 中 

wxMenuBar *menuBar = new wxMenuBar(); 
menuBar ->Append(fileMenu, wxT("&File")); 
menuBar ->Append(helpMenu, wxT("&Help")); 


// .. .然后 将 菜单 条 放置 在 主 窗口 上 
SetMenuBar (menuBar ) ; 


// 创建 一 个 状态 条 来 让 一 切 更 有 趣 些 。 
CreateStatusBar (2); 
SetStatusText(wxT("Welcome to wxWidgets!")); 


2.7 wxWidgets 程 序 一 般 执行 过 程 


下 面 大 概 的 描述 一 下 整个 程序 的 执行 过 程 : 


1， 依 照 系统 平台 的 不 同 ， 不 同 的 main 画 数 或 者 winmain 画 数 或 者 其 它 类 似 的 函数 被 调用 (这 
个 函数 是 由 wxWidgets 提 供 的 ,而 不 是 由 应 用 程序 提供 的 ).wxWidgets 初始 化 它 自己 的 数据 
结构 并 且 创 建 一 个 MyApp 的 实例 . 

2. wxWidgetsi4 FAMyApp::OnInit XX, 这 个 画 数 会 创建 一 个 MyFrame 的 实例 . 

3，MyFrame 的 构造 加 数 通过 它 的 基 类 WxFrame 的 构造 画 数 创建 一 个 窗口 ， 然 后 给 这 个 窗口 
增加 图 标 ， 菜 单 栏 和 状态 栏 . 

4.，MyApp::Onlnit 函 数 显 示 主 窗口 并 且 返 回 真 . 

5，wxWidgets 开 始 事 件 循 环 ， 等 待 事件 发 生 并 且 将 事件 分 发 给 相应 的 处 理 过 程 . 


就 目前 我 们 所 知道 的 ， 应 用 程序 会 在 以 下 情况 下 退出 : 主 窗口 被 关闭 ， 用 户 选择 退出 菜单 或 


者 系统 按钮 和 系统 菜单 中 的 关闭 选项 (这 些 系 统 菜单 和 系统 按钮 在 不 同 的 系统 中 就 往往 千 差 
万 别 了 ) 。 


2.8 编译 和 运行 程序 


你 可 以 在 附带 光盘 的 examples/chap02 里 找到 这 个 例子 。 你 可 能 需要 把 它 拷贝 到 你 硬盘 上 的 某 
个 目录 中 才能 进行 编译 。 因 为 要 提供 适合 所 有 读者 的 软件 环境 的 Makefile 几 乎 是 不 可 能 的 ， 我 
们 提供 了 一 个 DialogBlocks 的 项 目 文件 ， 并 且 把 我 们 能 想到 的 大 多 数 系统 平台 进行 了 配置 。 你 
可 以 参考 附录 C,“ 使 用 DialogBlocks 创 建 应 用 程序 ”来 找到 适合 你 自己 的 编译 器 的 编译 方法 。 
在 附录 B 中 ， 我 们 也 大 概 的 描述 了 直接 用 wxWidgets 编 译 的 方法 。 


你 可 以 从 CDRom 上 安装 wxWidgets 和 DialogBlocks， 如 果 你 使 用 的 是 windows 操 作 系统 并 且 
你 的 系统 中 还 没有 可 以 用 的 编译 器 ， 你 还 需要 安装 一 个 编译 器 。 然 后 运行 DialogBlocks， 并 且 
在 其 设置 叶 面 设置 你 的 wxWidgets 和 编译 器 的 路 径 ， 然 后 打开 examples/chap02/minimal.pj， 
选择 适合 你 的 编译 器 和 编译 平台 ， 比 如 Mingw Debug 或 者 VC++ Debug(Windows),GCC 
Debug GTK+(Linux), 或 者 GCC DEBUG Max(Max Os X) 等 ， 然 后 点 击 绿色 的 编译 和 运行 工程 
按钮 。 如 果 你 的 wxWidgets 库 还 没有 被 编译 ， 它 将 首先 编译 wxWidgets 库 。 


你 也 可 以 在 wxWidgets 的 sample/minimal 目 录 中 找到 一 个 类 似 的 例子 。 如 果 你 不 想 使 用 
DialogBlocks 编 译 ， 你 也 可 以 试 着 编译 这 个 例子 。 你 可 以 在 附录 A 入 “安装 wxWidgets” 中 找到 编 
译 这 个 例子 的 方法 ， 


第 二 章 小 结 


本 章 向 你 展示 了 一 个 非常 简单 的 wxWidgets 小 程序 是 怎样 工作 的 。 我 们 已 经 接触 到 了 
wxFrame 类 ， 事 件 处 理 ， 应 用 程序 初始 化 ， 并 且 创 建 了 一 个 菜单 条 和 状态 条 。 虽 然 代 码 看 上 
去 有 些 复杂 ， 但 是 任何 其 它 更 复杂 的 程序 设计 和 我 们 展示 在 这 个 小 例子 中 的 一 些 公共 的 原则 
都 是 相同 的 。 在 下 一 章 里 ， 我 们 会 更 近 距 离 的 看 一 看 事件 表 机 制 以 及 我 们 的 应 用 程序 是 怎样 
处 理事 件 表 的 。 


第 三 章 事件 义理 


3.1 事件 驱动 编程 


当 程 序 员 们 首次 面 对 菜 果 公 司 的 第 一 个 图 形 界面 个 人 电脑 的 时 候 ， 他 们 为 这 种 和 以 前 所 有 的 
经 验 都 不 同 的 电脑 操作 方法 感到 惊奇 。 鼠 标 指 针 在 一 个 个 的 窗口 之 间 移 来 移 去 ， 滚 动 条 ， 菜 
单 ， 文 本 编辑 框 等 等 等 等 ， 真 的 很 难以 想象 ， 这 么 多 让 人 眼花 绕 乱 的 东西 ， 其 背后 的 代码 该 
是 多 么 复杂 和 不 可 思议 。 似 乎 所 有 这 一 切 都 是 以 完全 并 行 的 方式 运行 的 ， 虽 然 这 只 是 一 个 假 
象 。 对 于 很 多 人 来 说 ， 茶 果 个 人 电脑 是 他 们 对 事件 驱动 编程 的 第 一 印象 。 


所 有 的 GUI 程序 都 是 事件 驱动 的 。 换 句 话 说， 应 用 程序 一 直 停留 在 一 个 循环 中 ， 等 待 着 来 自用 
户 或 者 其 他 地 方 〈 比 如 窗口 刷新 或 网 络 连接 ) 的 事件 ， 一 旦 收 到 某 种 事件 ， 应 用 程序 就 将 其 
扔 给 处 理 这 个 事件 的 画 数 。 哩 然 看 上 去 不 同 的 窗口 是 同时 被 刷新 的 ， 但 实际 上 ， 绝 大 多 数 的 
GUI 程序 都 是 单线 程 的 ， 因 此 窗口 的 刷新 是 依次 按 顺 序 进行 的 。 如 果 由 于 某 种 意外 你 的 电脑 变 
得 很 慢 导 致 窗口 刷新 的 过 程 变 的 很 明显 ， 你 就 会 注意 到 这 一 点 。 


不 同 的 GUI 编 程 架 构 用 不 同 的 方法 将 它 内 部 的 事件 处 理 机 制 展 现 给 程序 开发 者 。 对 于 
wxWidgets 来 说 ， 事 件 表 机 制 是 最 主要 的 方法 。 在 下 一 小 节 我 们 会 对 此 进行 进一步 的 解释 。 


3.2 事件 表 和 事件 处 理 过 程 


wxWidgets 事 件 久 理 系统 比 起 通常 的 虚 方法 机 制 来 说 要 稍微 复杂 一 点 ， 但 它 的 一 个 好 处 是 可 以 
避免 需要 实现 基 类 中 所 有 的 虚 方 法 ， 因 为 实现 所 有 的 基 类 虚 方 法 有 时 候 是 不 切实 际 的 或 者 是 
效率 很 低 的 。 


每 一 个 wxEvtHandler 的 派生 类 ， 例 如 frame， 按 钮 ， 菜 单 以 及 文档 等 ， 都 会 在 其 内 部 维护 一 
事件 表 ， 用 来 告诉 wxWidgets 事 件 和 事件 处 理 过 程 的 对 应 关系 。 所 有 继承 自 wxWindow 的 窗口 
类 ， 以 及 应 用 程序 类 都 是 wxEvtHandler 的 派生 类 . 


要 创建 一 个 静态 的 事件 表 ( 意 味 着 它 是 在 编译 期 间 创 建 的 )， 你 需要 下 面 几 个 步 又 : 


定义 一 个 直接 或 者 间接 继承 自 wxEvtHandler 的 类 . 

为 每 一 个 你 想 要 处 理 的 事件 定义 一 个 处 理 画 数 。 

在 这 个 类 中 使 用 DECLARE_EVENT_TABLE 声 明 事 件 表 。 

在 .cpp 文 件 中 使 用 使 用 BEGIN_EVENT_TABLE 和 END_EVENT_TABLE 实 现 一 个 事件 
表 。 

5. 在 事件 表 的 实现 中 增加 事件 宏 ， 来 实现 从 事件 到 事件 处 理 过 程 的 映射 。 


所 有 的 事件 义理 函数 拥有 相同 的 形式 。 他 们 的 返回 值 都 是 void， 他 们 都 不 是 虚 画 数 ， 他 们 都 只 
有 一 个 事件 对 象 作为 参数 。 (如 果 你 熟悉 MFC， 这 可 能 会 让 你 觉得 轻松 ， 因 为 在 MFC 中 消息 
义理 函数 并 没有 一 个 统一 的 形式 。) 这 个 事件 对 象 的 类 型 是 随 这 个 处 理 画 数 要 处 理 的 事件 的 
变化 而 变化 的 。 例 如 简单 控件 (比如 按钮 ) 的 命 合 处 理 画 数 和 菜单 命 合 的 处 理 画 数 的 参数 都 
是 wxCommandEvent 类 型 ， 而 size 事 件 (这 个 事件 通常 是 由 用 户 改变 窗口 的 客户 区 尺寸 而 引 
起 的 ) 义理 函数 的 参数 则 是 wxSizeEvent 的 类 型 。 不 同 的 事件 参数 类 型 可 以 调用 的 方法 也 不 相 
同 ， 通 过 这 些 方法 ， Re Otic bt au 
(比如 ， 文 本 框 中 的 值 的 改变 ) 。 当 然 最 简单 的 情形 是 你 完全 不 需要 访问 这 个 参数 的 任何 方 
法 ， 比 如 按钮 点 击 事件 。 
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处 理 。 下 面 是 扩展 以 后 的 MyFrame 的 定义 : 


class MyFrame : public wxFrame 


public: 
MyFrame(const wxString& title); 
void OnQuit(wxCommandEvent& event); 
void OnAbout (wxCommandEvent& event); 
void OnSize(wxSizeEvent& event); 
void OnButtonOK(wxCommandEvent& event); 
private: 
DECLARE_EVENT_TABLE( ) 
J; 


增加 菜单 项 的 代码 和 前 一 章 的 代码 类 似 ， 而 在 frame 窗口 增加 一 个 按钮 的 代码 也 只 需要 在 
MyFrame 的 构造 画 数 中 增加 下 面 的 代码 : 


wxButton* button = new wxButton(this, wxID_OK, wxT("OK"), 
wxPoint(200, 200)); 


类 似 的 ， 在 事件 表 中 也 需要 相应 的 增加 事件 映射 宏 : 


BEGIN_EVENT_TABLE(MyFrame, wxFrame) 


EVT_MENU (wxID_ABOUT, MyFrame: :OnAbout ) 
EVT_MENU (wxID_EXIT, MyFrame: :OnQuit ) 
EVT_SIZE ( MyFrame: :OnSize) 


EVT_BUTTON (wxID_OK, MyFrame: :OnButtonOK) 
END_EVENT_TABLE( ) 


当 用 户 点 击 关 于 菜单 或 者 退出 菜单 的 时 候 ， 这 个 事件 被 发 送 到 frame 窗 口 ， 而 MyFrame 的 事件 

告诉 wxWidgets， 对 于 标识 符 为 wxID_ABOUT 的 菜单 事件 应 该 发 送 到 MyFrame::OnAbout 
函数 ， 而 标识 符 为 wxID_EXIT 的 菜单 事件 应 该 发 送 到 MyFrame:: OnQuit 函 数 。 换 名 话说 : 当 
事件 义理 循环 义理 这 两 个 事件 的 时 候 ， 相 应 的 画 数 将 会 以 一 个 的 wxCommandEvent 类 型 的 参 
数 被 调用 。 


EVT_SIZE 事 件 映射 宏 不 需要 标识 符 参 数 因为 这 个 事件 只 会 被 产生 这 个 事件 的 控件 所 人 处理 。 


EVT_BUTTON 这 一 行将 导致 当 frame 窗 口 及 其 子 窗口 中 标识 符 为 wxID_OK 的 按钮 被 点 击 的 时 
候 ，OnButtonOK 画 数 被 调用 。 这 个 例子 表明 ， 事 件 可 以 不 必 被 产生 这 个 事件 的 控件 所 处 理 。 
让 我 们 假定 这 个 按钮 是 MyFrame 的 子 窗口 。 当 按钮 被 点 击 的 时 候 ，wxWidgets 会 首先 检查 
wxButton 类 是 否 指定 了 相应 的 处 理 画 数 ， 如 果 找 不 到 ， 则 在 其 父亲 的 类 所 属 的 事件 表 中 进行 
查找 ， 在 这 个 例子 中 ， 按 钮 的 父亲 是 MyFrame 类 型 的 一 个 实例 ， 在 其 事件 表 中 指明 了 一 个 对 
应 的 处 理 画 数 ， 因 此 MyFrame::OnButtonOK 函 数 就 被 调用 了 。 类 似 的 搜索 过 程 不 光 发 生 在 窗 
口 控件 的 父子 继承 树 中 ， 也 发 生 在 普通 的 类 继承 关系 中 ， 这 意味 着 你 可 以 选择 在 哪里 定义 事 
件 的 外 理 函数 。 举 例 来 说 ， 如 果 你 设计 了 一 个 对 话 框 ， 这 个 对 话 框 需要 响应 的 类 似 标识 符 为 
wxID_OK 的 command 事 件 。 但 是 你 可 能 需要 把 这 个 控件 的 创建 工作 留 给 使 用 你 的 代码 的 其 他 
的 程序 员 ， 只 要 他 在 创建 这 个 控件 的 时 候 使 用 同样 的 标识 符 ， 你 仍然 可 以 给 这 个 控件 为 这 个 
事件 定义 默认 的 处 理 东 数 。 


下 图 中 演示 了 一 次 普通 的 按钮 点 击 事件 发 生 以 后 ，wxWidgets 搜 索 所 有 事件 表 的 顺序 。 图 中 只 
演示 了 wxButton 和 MyFrame 两 次 继承 关系 。 当 用 户 点 击 了 确认 按钮 的 时 候 ， 一 个 新 的 
wxCommandEvent 事 件 被 创建 ， 其 中 包含 标识 符 wxID_OK 和 事件 类 型 
wxEVT_COMMAND_BUTTON_CLICKED， 然 后 这 个 按钮 的 事件 表 开 始 通过 
wxEvtHandler::ProcessEvent 函 数 进行 匹配 ， 事 件 表 中 的 每 一 个 条 目 都 会 去 尝试 匹配 ， 然 后 是 
其 父 类 wxControl 的 事件 表 ， 然 后 是 wxWindow 的 。 如 果 都 没有 匹配 到 ， wxWidgets 会 搜索 其 
父亲 的 类 事件 表 ， 然 后 就 找到 了 一 条 匹配 条 目 : 


EVT_BUTTON(wxID_OK, MyFrame: :OnButtonOK) 


因此 MyFrame::OnButtonOK 被 调用 了 。 







1. Clicking OK 
generates an 
event. 


a u 












wxCommandEvent 
wxEVT_COMMAND_BUTTON_CLICKED 
id=wxID_OK 


Instance of MyFrame 


2.Event tables 
are searched, 


child of 


3. An entry 
matched and the 
function is called, 





wxCommandEvent 
wxEVT_... CLICKED 
id=wxID_OK 
MyFrame::OnButtonOK 


需要 注意 的 事 : 只 有 Command 事 件 (其 事件 类 型 直接 或 者 间接 的 继承 自 wxCommandEvent) 才 
会 被 递 当 的 应 用 到 其 父亲 的 事件 表 。 通 常 这 是 wxWidgets 的 用 户 经 常会 感到 困惑 的 地 方 ， 因 此 
我 们 把 那些 不 会 传递 给 其 父亲 的 事件 表 的 事件 列举 如 下 : wxActivate, wxCloseEvent, 
wxEraseEvent, wxFocusEvent, wxKeyEvent, wxldleEvent, wxlnitDialogEvent， 
wxJoystickEvent, wxMenuEvent, wxMouseEvent, wxMoveEvent, wxPaintEvent, 
wxQueryLayoutInfoEvent, wxSizeEvent, wxScrollWinEvent, 和 

wxSysColourChangedEvent， 这 些 事件 都 不 会 传 给 事件 源 控件 的 父亲 . 


这 些 事件 不 会 传递 给 其 父亲 ， 是 因为 这 些 事件 仅 对 产生 这 个 事件 的 窗口 寺 有 意义 ， 举 例 来 
说 ， 把 一 个 子 窗口 的 重 绘 事件 发 送 给 它 的 父亲 ， 其 实 是 没有 任何 意义 的 。 


3 过 滤 某 个 事件 


wxWidgets 事 件 处 理 系 统 实现 了 一 些 和 C++ 中 的 虚 方 法 非常 类 似 的 机 制 ， 通 过 这 种 机 制 ， 你 可 
以 通过 重 载 某 种 基 类 的 事件 表 的 方法 来 改变 基 类 的 默认 的 事件 义理 过 程 。 在 多 数 情况 下 ， 通 
过 这 种 方法 ， 你 甚至 可 以 改变 本 地 原生 控件 的 默认 行为 。 举 例 来 说 ， 你 可 以 过 滤 某 些 按键 事 
件 以 便 本 地 原生 的 编辑 框 控件 不 处 理 这 些 按键 。 要 达到 这 个 目的 ， 你 需要 实现 一 个 继承 自 
wxTextCtrl 的 新 的 类 ， 然 后 在 其 事件 表 中 使 用 EVT_KEY_DOWN 事 件 映射 宏 。 过 滤 所 有 的 按键 
事件 也 许 不 是 你 想 要 的 ， 这 时 候 ， 你 可 以 通过 调用 wxEvent::Skip 函 数 来 提示 事件 处 理 过 程 对 
于 其 中 的 某 些 按键 事件 应 该 继续 寻找 其 父 类 的 事件 表 。 


总 的 来 说 ， 在 wxWidgets 中 ， 你 应 该 通过 调用 事件 的 Skip 方法 ， 而 不 是 通过 显 式 直接 调用 其 父 
类 对 应 画 数 的 方法 来 实现 对 特殊 事件 的 过 滤 。 


下 面 的 这 个 例子 演示 怎样 让 你 自己 的 文本 框 控 件 只 接受 "a" 到 "z" 和 "A" 到 "Z" 的 按键 ， 而 忽略 其 
它 按键 的 方法 : 


void MyTextCtrl: :OnChar(wxKeyEvent& event) 
if ( wxIsalpha( event.KeyCode() ) ) 


// 这 些 按键 在 可 以 接受 的 范围 ， 所 以 按照 正常 的 流程 处 理 
event.Skip(); 


else 
{ 
// SEBSARERIAOESAGR, MARN ASkipwR 
// AFSAREOZLAH ERA ASkipwHRM, MAFREN ETR 
// 再 继续 匹配 别 的 事件 表 ， 而 是 认为 事件 处 理 已 经 结束 
wxBell(); 


3.4 挂 载 事 件 表 


你 并 不 一 定 非 要 实现 继承 自 某 个 类 的 新 类 ， 才 可 以 改变 它 的 事件 表 。 对 于 那些 继承 自 
wxWindow 的 类 来 说 ， 有 另外 一 种 可 取代 的 方法 。 你 可 以 通过 实现 一 个 新 的 直接 继承 自 
wxEvtHandler 的 新 类 ， 然 后 定义 这 个 新 类 事件 表 ， 然 后 使 用 wxWindow::PushEventHandler 范 
数 将 这 个 事件 表 压 人 到 某 个 窗口 类 的 事件 表 栈 中 。 最 后 压 人 的 那个 事件 表 在 事件 匹配 过 程 中 
将 会 被 最 先 匹 配 ， 如 果 在 其 中 没有 匹配 到 对 应 的 事件 处 理 过 程 ， 那 么 栈 中 以 前 的 事件 表 仍 将 
被 匹配 ， 如 此 类 推 。 你 还 可 以 用 wxWindow::PopEventHandler 枉 数 来 阐 出 最 顶层 的 事件 表 ， 
如 果 你 给 wxWindow:: PopEventHandler 范 数 传 递 的 是 True 的 参数 ， 那 么 这 个 弹出 的 事件 表 闻 
被 删除 。 


这 种 方法 可 以 避免 大 量 的 类 重 载 ， 也 使 不 同 的 类 的 实例 共享 同一 个 事件 表 成 为 可 能 。 


有 时 候 ， 你 需要 手动 调用 窗口 类 的 事件 表 ， 这 时 候 你 应 该 使 用 wxWindow::GetEventHandler 
方法 ， 而 不 是 直接 使 用 调用 这 个 窗口 类 的 成 员 函 数 。 虽 然 wxWindow::GetEventHandler 通 常 
返回 这 个 窗口 类 本 身 。 但 是 如 果 你 之 前 便 经 使 用 PushEventHandler 压 人 另外 一 个 事件 表 ， 那 
么 男 数 将 会 返回 处 于 最 顶层 的 事件 表 。 因 此 使 用 wxWindow:: GetEventHandler 函 数 才 可 以 保 
证 事件 被 正确 的 处 理 。 


PushEventHandler 的 方法 通常 用 来 临时 的 或 者 永久 的 改变 图 形 界面 的 行为 。 举 例 来 说 ， 加 入 
你 想 在 你 的 应 用 程序 实现 对 话 框 编辑 的 功能 。 你 可 以 捕获 这 个 对 话 框 和 它 的 内 部 控件 的 所 有 
的 鼠标 事件 ， 先 使 用 你 自己 的 事件 表 人 处 理 这 些 事件 ， 来 进行 类 似 拖 搜 控件 ， 改 变 控 件 大 小 以 
及 移动 控件 动作 。 这 在 联机 教学 中 也 是 很 有 用 技术 。 你 可 以 在 你 自己 的 事件 表 中 过 滤 收 到 的 
事件 ， 如 果 是 可 以 接受 的 ， 则 调用 wxEvent::Skip 函 数 正 常 处 理 。 


3.5 动态 事件 义理 方法 


前 面 我 们 讨论 的 事件 义理 方法 ， 都 是 静态 的 事件 表 ， 这 也 是 我 们 义理 事件 最 常用 的 方式 。 接 
下 来 ， 我 们 来 讨论 一 下 事件 表 的 动态 处 理 ， 也 就 是 说 在 运行 期 改变 事件 表 的 映射 关系 。 使 用 
这 种 事件 映射 方法 的 原因 ， 可 能 是 你 想 在 程序 运行 的 不 同时 刻 使 用 不 同 的 映射 关系 ， 或 者 因 
为 你 使 用 的 那 种 语言 (例如 python) 不 支持 静态 映射 ， 或 者 仅仅 是 因为 你 更 喜欢 动态 映射 。 因 为 
动态 映射 的 方法 可 以 使 你 更 精确 的 控制 事件 表 的 细节 ， 你 其 至 可 以 单独 的 将 事件 表 中 的 某 一 
个 条 目 在 运行 期 打开 或 者 关闭 ， 而 前 面 说 的 PushEventHandler 和 PopEventHandler 的 方法 只 
能 针对 整个 事件 表 进 行 处 理 。 除 此 以 外 ， 动 态 事 件 义理 还 允许 你 在 不 同 的 类 之 间 共 享 事件 画 
数 。 


和 动态 事件 义理 相关 的 API 有 两 个 :wxEvtHandler:Connect 和 wxEvtHandler::Disconnect。 大 
多 数 情况 下 你 不 需要 手动 调用 wxEvtHandler::Disconnect 画 数 ， 这 个 函数 闻 在 窗口 类 被 释放 的 
时 候 自动 。 


下 面 我 们 还 用 前 面 的 MyFrame 类 来 举例 说 明 : 


class MyFrame : public wxFrame 


public: 
MyFrame(const wxString& title); 
void OnQuit(wxCommandEvent& event); 
void OnAbout (wxCommandEvent& event); 
private: 


你 可 能 已 经 注意 到 ， 这 次 我 们 没有 使 用 DECLARE_EVENT_TABLE 来 声明 一 个 事件 表 。 为 了 
动态 进行 事件 映射 ， 我 们 需要 在 Onlnit 函 数 中 增加 下 面 的 代码 : 


frame->Connect( wxID_EXIT, 
wXEVT_COMMAND_MENU_SELECTED, 
wxCommandEventHandler(MyFrame::OnQuit) ); 

frame->Connect( wxID_ABOUT, 
wxXEVT_COMMAND_MENU_SELECTED, 
wxCommandEventHandler(MyFrame::OnAbout) ); 


我 们 传递 给 Connect 事 数 的 三 个 参数 分 别 为 菜单 标识 符 ， 事 件 标 识 符 和 事件 处 理 画 数 指针 。 要 
注意 这 里 的 事件 标识 符 wxEVT_COMMAND _MENU_SELECTED 不 同 于 前 面 在 静态 事件 表 中 
用 于 表示 事件 映射 的 宏 EVT_MENU, 实 际 上 EVT_MENU 内 部 也 使 用 了 

wxEVT_COMMAND _MENU_SELECTED.EVT_MENU 其 实 也 自动 包含 了 用 于 对 事件 处 理 指 
针 类 型 强制 转换 的 宏 wxCommandEventHandler()。 一 般 说 来 ， 如 果 事 件 义理 函数 的 参数 类 型 
是 wxXYZEvent, 那 么 其 义理 函数 的 类 型 就 应该 用 wxXYZEventHandler 宏 进行 强制 转换 . 


如 果 我 们 希望 在 某 个 时 候 中 止 上 面 的 事件 映射 ， 可 以 使 用 下 面 的 方法 : 


frame->Disconnect( wxID_EXIT, 
wxXEVT_COMMAND_MENU_SELECTED, 
wxCommandEventHandler(MyFrame: :OnQuit) ); 

frame->Disconnect( wxID_ABOUT, 
wxXEVT_COMMAND_MENU_SELECTED, 
wxCommandEventFunction(MyFrame: :OnAbout) ); 


3.6 窗口 标识 符 


窗口 标识 符 是 在 事件 系统 中 用 来 唯一 确定 窗口 的 整数 。 事 实 上 ， 在 整个 应 用 程序 的 范围 内 ， 
窗口 标识 符 不 必 一 定 是 唯一 的 ， 而 只 要 在 某 个 国定 的 上 下 文 (比如 说 ， 在 一 个 frame 窗 口 和 它 的 
所 有 子 窗口 ) 内 是 唯一 的 就 可 以 了 。 举 例 来 说 : 你 可 以 在 无 数 个 对 话 框 中 使 用 wxID_OK 这 个 标 
识 符 ， 只 要 在 某 个 对 话 框 内 不 要 重复 使 用 就 可 以 了 。 


如 果 在 窗口 的 构造 函数 中 使 用 wxID_ANY 作 为 其 标识 符 ， 则 意味 着 你 希望 wxWidgets 自 动 为 你 
生成 一 个 标识 符 。 这 或 者 是 因为 你 不 关心 这 个 标识 符 的 值 ， 或 者 是 因为 这 个 窗口 不 需要 义理 
任何 事件 ， 或 者 是 因为 你 将 在 同一 个 地 方 处 理 所 有 的 事件 。 如 果 是 最 后 一 种 情况 ， 在 使 用 
wxEvtHandler:Connect 函 数 或 者 在 静态 事件 表 中 ， 你 应 该 使 用 wxID_ANY 作 为 窗口 的 标识 
符 。wxWidgets 自 动 创建 的 标识 符 是 总 是 一 个 负数 ， 所 以 永远 不 会 和 用 户 定义 的 窗口 标识 符 重 
复 ， 用 户 定义 的 窗口 标识 符 只 能 是 正 整 数 。 


下 表 列 举 了 wxWidgets 提 供 的 一 些 标准 的 标识 符 。 你 应 该 尽 可 能 的 使 用 这 些 标识 符 ， 这 是 由 于 
下 面 一 些 原因 。 某 些 系 统 会 给 特定 的 标识 符 提供 一 些小 图 片 (例如 GTK+ 系 统 上 的 OK 和 取消 按 
钮 ) 或 者 提供 默认 的 处 理 豆 数 (例如 自动 产生 wxID_CANCEL 事 件 来 响应 Escape 键 )。 在 Mac 
OS X 系 统 上 ，wxID_ABOUT, wxlID_PREFERENCES 和 wxID_EXIT 菜 单项 也 有 特别 的 处 理 。 

另外 一 些 wxWidgets 的 控件 也 会 自动 处 理 标识 符 为 wxID_COPY, wxID_PASTE 或 

wxID_ UNDO 等 的 一 些 菜单 或 者 按钮 的 命 倒 。 


标识 符 名 称 描述 
wxID_ANY 让 wxWidgets 自 动产 生 一 个 标识 符 
wxID_ LOWEST 最 小 的 系统 标识 符 值 (4999) 
wxID_HIGHEST 最 大 的 系统 标识 符 值 (5999) 
wxID_OPEN 打开 文件 
wxID_CLOSE 关闭 窗口 
wxID_NEW 新 建 窗口 文件 或 者 文档 
wxID_SAVE 保存 文件 
wxID_SAVEAS 文件 另存 为 (应 该 弹出 文件 位 置 对 话 框 ) 
wxID_REVERT 恢复 文件 在 磁 瘟 上 的 状态 
wxID_EXIT 退出 应 用 程序 
wxID_UNDO 撤消 最 近 一 次 操作 
wxID_REDO 重复 最 近 一 次 操作 


wxID_HELP 帮助 (例如 对 话 框 上 的 帮助 按钮 可 以 用 这 个 标识 符 ) 


wxID_PRINT_SETUP 
wxID_PREVIEW 
wxID_ABOUT 
wxID_HELP_CONTENTS 
wxID_HELP_COMMANDS 


wxID_HELP_PROCEDURES 


wxID_ HELP_CONTEXT 
wxID_CUT 

wxID_COPY 

wxID_PASTE 
wxID_CLEAR 

wxID_FIND 

wxID_ DUPLICATE 
wxID_SELECTALL 
wxID_DELETE 

wxID_ REPLACE 

wxID_- REPLACE_ALL 
wxID_ PROPERTIES 
wxID_VIEW_DETAILS 
wxID_VIEW_LARGEICONS 
wxID_VIEW_SMALLICONS 
wxID_VIEW_LIST 
wxID_VIEW_SORTDATE 
wxID_VIEW_SORTNAME 
wxID_VIEW_SORTSIZE 
wxID_VIEW_SORTTYPE 
wx!ID_FILE1 to wxID_FILE9 
wxID_OK 

wxID_CANCEL 
wxID_APPLY 

wxID_YES 


打印 设置 


打印 预览 

显示 一 个 用 来 描述 整个 程序 的 对 话 框 
显示 上 下 文 帮助 
显示 应 用 程序 命令 
显示 应 用 程序 过 程 
未 使 用 

剪 切 
复制 到 剪贴 板 
粘贴 

清除 

查找 

复制 

全 选 

删除 

覆盖 

全 部 覆盖 

查看 属性 


列表 框 中 的 按照 详细 信息 方式 显示 

列表 框 按照 大 图 标的 方式 显示 

列表 框 中 按照 小 图 标的 方式 显示 

列表 框 中 按照 列表 的 的 方式 显示 

按照 日 期 排序 

按照 名 称 排序 

按照 大 小 排序 

按照 类 型 排序 
显示 最 近 使 用 的 文件 

确定 

取消 


wxID_NO 
wxID_STATIC 
wxID_FORWARD 
wxID_BACKWARD 
wxID_DEFAULT 
wxID_ MORE 
wxID_SETUP 
wxID_RESET 
wxID_CONTEXT_HELP 
wxID_YESTOALL 
wx!ID_ NOTOALL 
wxID_ABORT 
wxID_RETRY 
wxID_IGNORE 
wxID_UP 

wxID_ DOWN 

wx!ID_ HOME 
wxID_REFRESH 
wxID_ STOP 
wxID_INDEX 

wxID_ BOLD 
wx!ID_ITALIC 
wxID_JUSTIFY_CENTER 
wxID_JUSTIFY_FILL 
wxID_ JUSTIFY _RIGHT 
wxID_ JUSTIFY _LEFT 
wxID_UNDERLINE 
wxID_INDENT 
wxID_UNINDENT 
wxID_ZOOM_100 
wxID_ZOOM_FIT 
wxID_ZOOM_IN 


No 


静态 文本 或 者 静态 图 片 可 以 用 这 个 标识 符 


向 前 


全 部 选 否 

中 止 当前 操作 
重 试 

忽略 错误 
向 上 

向 下 

首页 

刷新 
停止 正在 进行 的 操作 
显示 一 个 索引 
加 粗 显示 
斜体 显示 
居中 

格式 


反 缩 进 
放大 到 100% 
缩放 到 整 页 


放大 


wxID_ZOOM_OUT 缩小 
wxID UNDELETE 反 删 除 
wxID_REVERT_TO_SAVED 恢复 到 上 次 保存 的 状态 


为 了 避免 你 自己 定义 的 标识 符 和 这 些 预 定义 的 标识 符 重 复 ， 你 可 以 使 用 大 于 wxID_HIGHEST 
的 标识 符 或 者 小 于 wxID_LOWEST 的 标识 符 。 


3.7 目 定 义 事件 


如 果 你 要 使 用 自 定义 的 事件 ， 你 需要 下 面 的 几 个 步 又 : 


1， 从 一 个 合适 的 事件 类 派生 一 个 你 自己 的 事件 类 ， 声 明 动 态 类 型 信息 并 且 实 现 一 个 Clone 范 
数 ， 按 照 你 自己 的 意愿 增加 新 的 数据 成 员 和 男 数 成 员 . 如 果 你 希望 这 个 事件 在 窗口 继承 关 
系 之 间 传 递 ， 你 应 该 使 用 的 wxCommandEvent 派 生 类 ， 如 果 你 希望 这 个 事件 的 处 理 函 数 
可 以 调用 Veto( 译 者 注 : 某 些 事件 可 以 调用 这 个 函数 来 阻止 后 续 可 能 对 这 个 事件 进行 的 任何 
操作 (如 果 有 的 话 )， 最 典型 的 例子 是 关闭 窗口 事件 wxEVT_CLOSE)， 你 应 该 使 用 
wxNotifyEvent 的 派生 类 . 

2. 为 这 个 事件 类 的 处 理 画 数 定义 类型. 

3， 定 义 一 个 你 的 事件 类 支持 的 事件 类 型 的 表 。 这 个 表 应 该 定义 在 你 的 头 文件 中 。 用 
BEGIN_DECLARE_EVENT_TYPES() 宏 和 END_DECLARE_EVENT_TYPES() 宏 包含 起 
来 。 其 中 的 每 一 个 支持 的 事件 的 声明 应 该 使 用 DECLARE_EVENT_TABLE (name， 
integer) 格 式 的 宏 . 然 后 在 你 的 .cpp 文 件 中 使 用 DEFINE_EVENT_TYPE(name) 来 实现 这 个 
事件 类 . 

4. 为 每 个 你 的 事件 类 支持 的 事件 定义 一 个 事件 映射 宏 。 


我 们 还 是 通过 例子 来 让 上 面 这 段 绕 口 的 话 显 的 更 生动 一 些 。 假 如 我 们 要 实现 一 个 新 的 控件 
wxFontSelectorCtrl, 这 个 控件 将 可 以 显示 字体 的 预览 。 用 户 通 过 点 击 字 体 的 预览 来 弹出 一 个 对 
话 框 让 用 户 可 以 更 改 字体 。 应 用 程序 也 许 想 拦截 这 个 字体 改变 事件 ， 因 此 我 们 在 我 们 的 底层 
鼠标 消息 义理 过 程 中 将 会 给 应 用 程序 发 送 一 个 自 定 义 的 字体 改变 事件 。 


因此 我 们 需要 定义 一 个 新 的 事件 wxFontSelectorCtrIEvent. 应 用 程序 可 以 通过 事件 映射 宏 
EVT_FONT_SELECTION_CHANGED(id, func) 来 增加 对 这 个 事件 的 处 理 。 我 们 还 需要 给 这 个 
事件 定义 一 个 事件 类 型 : wxEVT_COMMAND FONT_SELECTION _CHANGED. 这 样 ， 我 们 
的 头 文 件 看 上 去 就 象 下 面 的 样子 : 


/*! 
* Font selector event class 
a 
class wxFontSelectorCtrlEvent : public wxNotifyEvent 


public: 
wxFontSelectorCtrlEvent(wxEventType commandType = wxEVT_NULL, 
int id = 0): wxNotifyEvent(commandType, id) 


wxFontSelectorCtrlEvent(const wxFontSelectorCtrlEvent& event): wxNotifyEvent(event) 
{} 
Virtual wxEvent *Clone() const 
{ return new wxFontSelectorCtrlEvent(*this); } 
DECLARE_DYNAMIC_CLASS(wxFontSelectorCtrlEvent) ; 
J; 
typedef void (wxEvtHandler: : *wxFontSelectorCtrlEventFunction) 
(wxFontSelectorCtrlEvent&) ; 
pol] 
* Font selector control events and macros for handling them 
aif 
BEGIN_DECLARE_EVENT_TYPES( ) 
DECLARE_EVENT_TYPE(wxEVT_COMMAND_FONT_SELECTION_CHANGED, 801) 
END_DECLARE_EVENT_TYPES( ) 
#define EVT_FONT_SELECTION_CHANGED(id, fn) DECLARE_EVENT_TABLE_ENTRY( 
wxEVT_COMMAND_FONT_SELECTION_CHANGED, id, -1, (wxObjectEventFunction) (wxEventFunction) 
(wxFontSelectorCtrlEventFunction) & fn, 
(wxObject *) NULL ), 


RS =f) 
而 在 我 们 的 .cpp 文 件 中 ， 看 上 去 则 象 下 面 的 样子 : 


DEFINE_EVENT_TYPE(wxEVT_COMMAND_FONT_SELECTION_CHANGED) 
IMPLEMENT_DYNAMIC_CLASS(wxFontSelectorCtrlEvent, wxNotifyEvent) 


然后 ， 在 我 们 的 新 控件 的 鼠标 义理 函数 中 ， 可 以 通过 下 面 的 方法 在 检测 到 用 户 选 择 了 一 个 新 
的 字体 的 时 候 ， 发 送 一 个 自 定 义 的 事件 : 


wxFontSelectorCtrlEvent event( 
wxEVT_COMMAND_FONT_SELECTION_CHANGED, GetId()); 

event .SetEventObject(this); 

GetEventHandler ()->ProcessEvent(event); 


现在 ， 在 使 用 我 们 的 新 控件 的 点 用 程序 的 代码 中 就 可 以 通过 下 面 代 码 来 处 理 我 们 定义 的 这 个 
新 事件 了 : 


BEGIN_EVENT_TABLE(MyDialog, wxDialog) 
EVT_FONT_SELECTION_CHANGED(ID_FONTSEL, MyDialog: :OnChangeFont) 

END_EVENT_TABLE( ) 

void MyDialog: :OnChangeFont(wxFontSelectorCtrlEvent& event) 


// 字体 已 经 更 改 了 ， 可 以 作 一 些 必 要 的 处 理 。 


上 面 用 到 的 事件 标识 符 801 在 最 新 的 版 本 中 已 经 没有 用 外 了 ， 之 所 以 这 样 写 只 是 为 了 兼容 
wxWidgets2.4 的 版 本 。 


oy 


让 我 们 再 来 看 一 眼 事 件 映 射 宏 的 定义 : 


#define EVT_FONT_SELECTION_CHANGED(id, fn) DECLARE_EVENT_TABLE_ENTRY( 
wxEVT_COMMAND_FONT_SELECTION_CHANGED, id, -1, (wxObjectEventFunction) (wxEventFunction) 
(wxFontSelectorCtrlEventFunction) & fn, 

(wxObject *) NULL ), 


了 = 2| 


这 个 宏 的 作用 其 实 是 把 一 个 五 元 组 放 入 到 一 个 数组 中 ， 所 以 这 段 代 码 的 语法 看 上 去 是 奇怪 了 
一 些 ， 这 个 五 元 组 的 意义 分 别 解 释 如 下 : 








。 事件 类 型 :一 个 事件 类 可 以 处 理 多 种 事件 类 型 ， 但 是 在 我 们 的 例子 中 ， 只 人 处理 了 一 个 事件 
类 型 ， 所 以 就 只 有 一 个 事件 映射 宏 的 记录 。 这 个 事件 类 型 必须 要 和 事件 处 理 函 数 所 有 处 
理 的 事件 的 类 型 一 致 。 

。 传递 给 事件 映射 宏 的 标识 符 :只 有 当 事 件 的 标识 符 和 事件 表 中 的 标识 符 一 致 的 时 候 ， 相 应 
NSE RIERA Sia. 

。 第 二 标识 符 。 在 这 里 -1 表示 没有 第 二 标识 符 。 

。 事件 处 理 男 数 。 如 果 没有 类 型 的 强制 转换 ， 一 些 编译 器 会 报错 ， 这 也 就 是 我 们 要 定义 事 
件 处 理 函 数 类 型 的 原因 。 

。 用 户 数 据 ， 通 常 都 是 NULL; 


随 书 附带 光盘 中 的 examples/chap03 目 录 中 有 一 个 完整 的 自 定义 事件 的 例子 ， 其 中 包括 了 一 个 
字体 选择 控件 和 一 个 简单 验证 类 ， 你 可 以 在 你 的 点 用 程序 中 使 用 她 们 。 你 还 可 以 阅读 你 的 
wxWidgets 发 行 版 目录 中 的 include/wx/event.h 来 获得 更 多 的 灵感 。 


第 三 草 小 结 


在 这 一 章 里 ， 我 们 讨论 了 wxWidgets 中 的 事件 分 发 机 制 ， 以 及 怎样 进行 动态 事件 处 理 ， 还 谈 到 
了 窗口 标识 符 以 及 怎样 使 用 自 定义 的 事件 。 更 多 关于 事件 处 理 的 内 容 ， 你 可 以 参考 附录 
H,"wxWidgets 怎 样 处 理事 件 "以 及 附录 "事件 处 理 类 和 宏 ", 那 里 列举 了 主要 的 事件 处 理 的 类 和 
宏 。 你 还 可 以 参考 大 量 的 wxWidgets 的 例子 来 学 习 事件 的 用 法 ,尤其 是 wxWidgets 发 行 版 目录 
samples/event 这 个 例子 。 


在 下 一 章 里 ， 我 们 将 讨论 一 系列 重要 的 GUI 控 件 以 及 如 何在 你 的 程序 中 使 用 这 些 控件 . 


第 四 章 窗口 的 基础 知识 


在 这 一 章 中 ， 在 详细 描述 应 用 程序 中 大 量 使 用 的 各 种 窗口 类 之 前 ， 我 们 首先 来 看 看 一 个 窗口 
的 主要 元 素 。 这 些 要 素 中 的 大 部 分 相信 你 以 前 在 各 种 平台 上 的 编程 经 验 或 者 使 用 经 验 足 以 让 
你 对 它们 非常 的 熟悉 。 虽 然 总 会 有 一 些 平台 相关 的 差异 ， 但 是 你 会 发 现 ， 单 就 功能 上 来 说 ， 
各 个 平台 之 间 有 着 惊人 的 相似 ， 而 wxWidgets 已 经 屏 殴 了 几乎 所 有 这 些 平台 上 的 差异 ， 还 剩 
下 的 一 小 部 分 差异 ， 主 要 体现 在 各 个 平台 可 选 的 窗口 类 型 上 的 不 同 。 


4.1 窗口 解析 


你 当然 大 略 的 知道 一 个 窗口 指 的 是 什么 ， 但 是 为 了 更 好 的 理解 wxWidgets 的 API, 你 应 该 更 精通 
wxWidgets 使 用 的 窗口 模型 的 细节 。 它 可 能 和 你 在 某 个 特定 平台 上 的 窗口 概念 有 些许 的 不 同 。 
下 图 演示 了 一 个 窗口 中 的 各 个 基本 元 素 : 


Window border and decorations 


Client area 


Optional 
scrollbars 





Child window 
窗口 的 概念 


一 个 窗口 指 的 是 屏幕 上 的 任何 一 个 拥有 以 下 特征 的 规则 区 域 : 它 可 以 被 改变 大 小 ， 可 以 自我 
刷新 ， 可 以 被 显示 和 隐藏 等 等 。 它 可 以 包含 别 的 窗口 (比如 frame 窗 口 就 可 以 包含 菜单 条 窗口 ， 
工具 条 窗口 以 及 状态 条 窗口 )， 也 可 以 子 窗口 (比如 一 个 静态 的 文本 或 者 一 副 静 态 图 片 )。 通 常 
你 在 使 用 wxWidgets 编 写 的 程序 运行 的 屏幕 上 看 到 的 窗口 ， 都 和 一 个 wxWindow 类 或 者 它 的 派 
生 类 对 应 ， 当 然 也 不 总 是 这 样 。 比 如 本 地 原生 下 拉 框 就 不 总 是 用 wxWindow 建 模 的 。 


客户 区 和 非 客 户 区 


当 我 们 谈 到 窗口 的 大 小 ， 我 们 通常 指 的 是 它 整个 的 大 小 ， 包 括 一 些 用 于 修饰 的 边框 和 标题 栏 
等 。 而 当 我 们 谈 到 一 个 窗口 的 客户 区 大 小 ， 通 常 都 只 意味 着 窗口 里 面 那些 能 被 绘制 或 者 它 的 
子 窗口 能 被 放置 的 位 置 的 大 小 。 例 如 一 个 frame 窗 口 的 客户 区 大 小 就 不 包括 那些 菜单 栏 ， 状 态 
栏 和 工具 栏 所 占用 的 地 方 。 


滚动 条 


大 多 数 窗口 都 有 显示 滚动 条 的 能 力 ， 这 些 滚动 条 通常 是 窗口 自己 增加 的 而 不 是 有 应 用 程序 手 
动 增 加 的 。 在 这 种 情况 下 ， 客 户 区 的 大 小 还 应 该 减 去 滚动 条 所 占用 的 空间 。 为 了 优化 性 能 ， 
只 有 那些 拥有 wxHSCROLL 和 wxVSCROLL 类 型 的 窗口 才 会 自动 生成 它们 自己 的 滚动 条 。 关 于 
滚动 条 更 多 的 情形 我 们 会 在 本 章 稍 候 讨 论 wxScrolledWindow 的 时 候 讨 论 。 


光标 和 刀 标 指针 


一 个 窗口 可 以 拥有 一 个 光标 (wxCaret, 用 来 显示 当前 的 文本 位 置 ) 和 一 个 鼠标 指针 (wxCursor, 用 
来 显示 当前 鼠标 指针 的 位 置 ). 当 鼠标 移入 某 个 窗口 时 ，wxWidgets 会 自动 显示 这 个 窗口 的 鼠标 
指针 。 当 一 个 窗口 变 为 当前 焦点 窗口 时 ， 如 果 可 以 的 话 ， 光 标 将 会 显示 在 当前 文本 的 插入 位 
置 ， 或 者 如 果 这 个 焦点 是 由 于 思 标 点 击 造成 的 ， 光 标 将 会 显示 在 鼠标 对 应 的 位 置 。 


顶层 窗口 


窗口 通常 分 为 象 wxFrame,wxDialog,wxPopup 这 样 的 顶层 窗口 和 其 它 窗口 。 只 有 顶层 窗口 创建 
的 时 候 可 以 使 用 NULL 作 为 其 父 窗口 ， 也 指 有 顶层 窗口 是 延迟 删除 的 (所 谓 延 迟 删 除 的 意思 是 
说 ， 它 们 只 有 在 系统 空闲 的 时 候 示 会 被 删除 ， 也 就 是 说 只 有 当 所 有 的 事件 都 被 处 理 完 以 后 才 
会 被 删除 )。 而 且 出 了 Popup 窗 口 以 外 ， 顶 层 窗口 通常 都 有 一 个 标题 栏 和 一 个 关闭 按钮 ， 只 要 
应 用 程序 允许 ， 它 们 就 可 以 被 搜 着 满 屏幕 的 跑 或 者 被 改变 大 小 。 


座 标 体系 


窗口 的 座 标 体系 通常 是 左上 角 为 原点 (0,0), 单 位 是 象 素 。 在 某 个 用 于 窗口 绘制 的 特定 的 上 下 文 
中 ， 原 点 和 比例 允许 被 改变 。 这 方面 详细 的 可 以 参考 第 5 章 , "窗口 绘 制 和 打印 " 


窗口 绘制 


当 一 个 窗口 需要 重 绘 的 时 候 ， 它 将 收 到 两 个 事件 ，wxEVT_ERASE_BACKGROUND 事 件 用 于 
通知 应 用 程序 重新 绘制 背景 ， wxEVT_PAINT 则 用 于 通知 重新 绘制 前 景 。 那 些 已 经 准备 好 使 用 
的 窗口 空间 比如 wxButton( 按 钮 ) 通 常 知道 怎么 处 理 这 两 个 事件 ， 但 是 如 果 你 是 要 创建 自己 的 窗 
口 控件 ， 你 就 需要 自己 处 理 这 两 个 事件 了 。 通 过 获取 窗口 的 变动 区 域 你 可 以 优化 你 的 绘制 代 
码 。 


颜色 和 字体 


每 一 个 窗口 都 有 一 个 前 景色 和 一 个 背景 色 。 默 认 的 背景 擦 除 函 数 会 使 用 背景 色 来 清除 窗口 背 
景 ， 如 果 没 有 设置 背景 色 ， 则 会 使 用 当前 的 系统 皮肤 推荐 的 颜色 进行 背景 的 清除 。 前 景色 则 
相对 来 说 很 少 被 用 到 。 每 一 个 窗口 也 拥有 一 个 字体 设置 ， 是 否 用 到 这 个 字体 设置 要 取决 于 这 
个 窗口 本 身 的 类 型 。 


窗口 变 体 


在 Mac OS X 上 ， 一 个 窗口 有 一 个 窗口 变 体 的 概念 ， 通 过 这 个 概念 窗口 可 以 被 以 不 同 级 别 的 大 
小 显示 : wxWINDOW _VARIANT_NORMAL( 默 认 显示 级 别 )， 
wxWINDOW_VARIANT_SMALL, wxWINDOW_VARIANT_MINI, 或 者 

wxWINDOW _VARIANT_LARGE. 当 你 有 很 多 信息 要 展示 而 屏幕 空间 不 够 的 时 候 ， 你 可 以 使 用 
相对 较 小 的 级 别 ， 但 是 这 个 显示 级 别 的 使 用 应 该 适可而止 。 有 些 程序 总 是 喜欢 使 用 小 的 显示 
级 别 。 


改变 大 小 


当 一 个 窗口 的 大 小 ， 无 论 是 来 自用 户 还 是 应 用 程序 本 身 的 原因 ， 发 生变 化 时 ， 它 将 收 到 一 个 
wxEVT_SIZE 事 件 。 如 果 这 个 窗口 拥有 子 窗口 ， 它 们 可 能 需要 被 重新 放置 和 重新 计算 大 小 。 
处 理 这 种 情况 推荐 的 方法 是 使 用 sizer 类 ， 关 于 这 个 类 的 细节 将 在 第 7 章 ，" 使 用 Sizer 确 定 窗口 
的 布局 " 这 一 章 详细 介绍 。 大 多 数 已 经 确定 的 窗口 类 都 有 一 个 默认 的 大 小 和 位 置 ， 这 需要 你 在 
创建 这 些 窗口 的 时 候 使 用 wxDefaultSize 和 wxDefaultPosition 这 两 个 特殊 的 值 。 到 目前 为 止 ， 
每 一 个 控件 都 实现 了 DoGetBestSize 函 数 ， 这 个 玉 数 会 返回 一 个 基于 控件 的 内 容 ， 当 前 字体 以 
及 其 它 各 方面 来 说 最 合理 的 大 小 。 


输入 


任何 窗口 在 任何 时 候 都 可 以 接收 到 妃 标 事件 ， 除 非 某 个 窗口 已 经 临时 捕获 了 鼠标 或 者 这 个 窗 

口 已 经 被 禁止 使 用 了 ， 而 对 于 键盘 事件 来 说 ， 只 有 当前 处 于 活动 状态 的 窗口 才 可 以 收 到 。 应 

用 程序 自己 可 以 设置 自己 为 活动 状态 ，wxWidgets 也 会 在 用 户 点 击 某 个 窗口 的 时 候 将 其 设置 为 
活动 状态 。 正 变 成 活动 状态 的 窗口 会 收 到 wxEVT_SET_FOCUS 事 件 ， 而 正 失 去 焦点 的 窗口 会 
收 到 wxEVT_KILL_FOCUS 事 件 。 请 参考 第 6 章 : 义理 输入 。 


空闲 事件 处 理 和 用 户 界面 更 新 


所 有 的 窗口 (除非 特殊 声明 ) 都 将 收 到 空闲 事件 wxEVT_IDLE, 这 个 事件 是 在 所 有 其 它 的 事件 都 已 
经 被 处 理 完 以 后 发 出 的 。 使 用 EVT_IDLE 事 件 映射 宏 来 处 理 。 更 多 的 信息 请 参 卡 第 17 章 ," 多 线 
程 编程 "中 的 " 空 闪 时 间 处 理 "小 节 . 


其 中 一 个 特殊 的 空闲 时 间 操 作 就 是 进行 用 户 界面 更 新 ， 在 这 个 操作 中 所 有 的 窗口 都 可 以 定义 
一 个 函数 来 更 新 自己 的 状态 。 这 个 男 数 将 会 被 周期 性 的 在 系统 空 几 时 调用 。 而 
EVT_UPDATE_Ul(id, func) 这 个 宏 则 通常 不 需要 作 什 么 事情 。 更 多 关于 用 户 界面 更 新 的 细节 请 
参考 第 9 章 ," 创 建 自 定义 对 话 框 ". 


窗口 的 创建 和 删除 


一 般 来 说 ， 窗 口 都 是 在 堆 上 使 用 new 方 法 创建 的 ， 第 15 章 ，" 内 存 管理 ， 调 试 和 错误 检查 "这 一 
章 对 此 有 详细 的 描述 ， 也 会 提 到 一 些 例外 情况 。 大 多 数 的 窗口 类 都 可 以 通过 两 种 方法 被 创 
建 : 单 步 创 建 和 两 步 创 建 。 比 如 wxButton 的 两 种 构造 画 数 如 下 : 


wxButton(); 
wxBut ton(wxWindow* parent, 
wxWindowID id, 
const wxString& label = wxEmptyString, 
const wxPoint& pos = wxDefaultPosition, 
const wxSize& size = wxDefaultSize, 
long style = 0, 
const wxValidator& validator = wxDefaultValidator, 
const wxString& name = wxT("button")); 


下 面 演示 了 使 用 一 步 创 建 的 方法 创建 一 个 wxButton 的 实例 (其 中 多 数 参数 采用 默认 值 ) : 


wxButton* button = new wxButton(parent, wxID_OK); 


PRiEeframekAdialogHO, 4 FAKA, Bae EAAS DERA. 
这 会 自动 把 这 个 新 窗口 作为 这 个 父 窗口 的 子 窗口 。 当 父 窗口 被 释放 的 时 候 ， 它 的 所 有 的 子 窗 
口 也 将 被 释放 。 正 象 我 们 前 面 提 到 的 那样 ， 你 必须 输入 一 个 自 定 义 的 或 者 系统 内 建 的 标识 符 
给 这 个 窗口 以 便 唯 一 标识 这 个 窗口 。 你 也 可 以 使 用 wxID_ANY 宏 让 wxWidgets 帮 你 生成 一 个 。 
你 可 以 传递 位 置 和 大 小 参数 给 这 个 窗口 ， 一 个 校 验 类 (参考 第 9 章 )， 一 个 类 型 ( 接 下 来 会 提 
到 )， 和 一 个 字符 串 的 名 字 。 这 个 字符 串 的 名 字 可 以 是 任意 的 值 或 者 干脆 不 填 也 可 以 。 只 有 在 
Xt 和 Meotif 系 统 上 这 个 参数 寺 有 意义 ， 因 为 在 这 些 系 统 上 控件 是 通过 它们 的 名 字 来 区 分 的 ,平常 
情况 下 则 很 少 用 到 。 


两 步 创建 的 意思 是 说 ， 你 先 使 用 默认 的 构造 画 数 创建 一 个 实例 ， 然 后 再 使 用 这 个 实例 Create 
方法 实际 创建 这 个 对 象 。Create 的 参数 和 前 面 使 用 的 构造 画 数 的 参数 完全 相同 ,还 是 用 
wxButton 作 为 例子 : 


wxButton* button = new wxButton; 
button->Create(parent, wxID_OK); 


BOER Create Ay at (RAI EWxEVT_CREATES(4, (RALAst XPS MTHS 
的 义理 。 


使 用 两 步 创 建 的 原因 是 什么 呢 ? 第 一 个 原因 是 有 时 候 你 可 能 想 在 晚 些 时 候 ， 在 真正 需要 的 时 
候 才 完整 的 创建 窗口 。 另 外 一 个 原因 是 你 希望 在 调用 Create 函 数 之 前 设置 窗口 的 某 些 属性 
值 。 尤 其 是 这 些 属性 值 被 Create 函 数 使 用 的 时 候 就 显 的 更 有 意义 。 例 如 你 可 能 想 在 窗口 被 创 
建 之 前 设置 wxWS_EX_VALIDATE_RECURSIVELY 扩 展 类 型 ， 而 这 个 类 型 必须 通过 
SetExtraStyle 本 数 才 可 以 设置 。 在 这 种 情况 下 ， 对 某 些 对 话 框 类 而 言 ，validation 必 须 在 
Create 画 数 被 调用 之 前 被 初始 化 。 所 以 如 果 你 需要 这 个 功能 ， 就 必须 在 调用 Create 之 前 初始 
化 这 个 值 。 


当 你 创建 一 个 窗口 类 ， 或 者 其 它 任何 非 顶 层 窗 口 的 派生 类 的 时 候 ， 如 果 它 的 父 窗口 是 可 见 
的 ， 那 么 它 也 总 是 可 见 的 ， 你 可 以 通过 Show(false) 来 使 它 不 可 见 。 这 和 wxDialog 或 者 
wxFrame 这 样 的 顶层 窗口 是 不 一 样 的 。 顶 层 窗口 在 创建 时 通常 是 不 可 见 的 ， 这 样 可 以 避免 绘 


制 那 些 子 窗口 和 排列 子 控件 的 时 候 发 生 闪烁 。 你 需要 通过 Show 或 者 (对 于 模式 对 话 框 来 
说 )ShowModal 的 调用 让 它 可 见 。 


窗口 是 通过 调用 其 Destroy 函 数 (对 于 顶层 窗口 来 说 ) 或 者 delete 函 数 ( 对 于 其 子 窗口 来 说 ) 来 释放 
的 。wxEVT_DESTROY 事 件 会 在 窗口 刚刚 要 被 释放 之 前 被 调用 。 实 际 上 ， 子 窗口 是 被 自动 释 
放 的 ， 所 以 delete 函 数 是 很 少 直接 被 手动 调用 的 。 


窗口 类 型 


窗口 拥有 一 个 类 型 和 一 个 扩展 类 型 。 窗 口 类 型 是 设置 窗口 创建 时 的 行为 和 外 观 的 一 种 简洁 的 
方法 。 这 些 类 型 的 值 被 设置 成 可 以 使 用 类 似 比 特 位 的 方法 操作 ， 例 如 下 面 的 例子 : 


wxCAPTION | wxMINIMIZE BOX | wxMAXIMIZE BOX | wxTHICK_FRAME 


wxWindow 类 有 一 组 基本 的 类 型 值 ， 例 如 边框 的 类 型 等 ， 每 一 个 派生 类 可 以 增加 它们 自己 的 类 
型 。 需 要 特别 指出 的 是 ， 扩 展 类 型 的 值 是 不 可 以 拿 来 给 类 型 用 的 。 


4.2 窗口 类 概 蝎 


在 接 下 来 的 章节 中 ， 我 们 会 介绍 最 常用 的 那些 窗口 类 以 便 你 可 以 在 你 的 应 用 程序 中 使 用 它 
们 。 然 而 如 果 你 是 第 一 Re 你 可 以 直接 跳 到 第 5 章 阅 读 后 面 的 内 容 ， 而 在 晚 些 时 候 
你 需要 使 用 的 时 候 再 回 过 头 来 阅读 本 章 的 内 容 。 


为 了 让 你 先 大 致 浏览 一 了 我 们 把 本 章 将 会 讨论 的 窗口 类 列举 如 下 。 对 于 其 他 一 
些 窗口 类 ， 请 参考 第 12 章 ," 高 级 窗口 类 "以 及 附录 E,"wxWidgets 中 的 第 三 方 工具 ". 


基本 窗口 类 
下 面 的 这 些 基本 的 窗口 类 实现 了 一 些 最 基本 的 功能 。 这 些 类 主要 是 用 来 作为 别 的 类 型 的 基 关 
以 生成 更 实用 的 派生 关 。 


e wxWindow. 这 是 所 有 窗口 类 的 基 类 。 
e wxControl. 所 有 控件 (比如 wxButton) 的 基 类 . 
e WXControlWithltems. 是 那些 拥有 多 个 子 项 目的 控件 的 基 类 . 


顶层 窗口 类 


顶层 窗口 类 通常 指 那些 独立 的 位 于 桌面 上 的 类 。 


wxFrame. 一 个 可 以 包含 其 他 窗口 ， 并 且 大 小 可 变 的 窗口 类 。 
wxMDIParentF rame. 是 一 个 可 以 管理 其 他 Frame 类 的 类 . 
wxMDIChildFrame. 是 一 个 可 以 被 其 父 窗口 管理 的 frame 类 . 
e wxDialog. 是 一 种 可 变 大 小 的 用 于 给 用 户 提供 选项 的 窗口 类 . 
e wxPopupWindow. 是 一 种 暂 态 的 只 有 很 少 修饰 的 顶层 窗口 . 


容器 窗口 类 

容器 窗口 类 可 以 管理 其 他 窗口 
e wxPanel. 这 是 一 个 给 其 它 窗口 提供 布局 的 窗口 . 
e wxNotebook. 可 以 实用 TAB 页 面 进行 切换 的 窗口 . 


e wxScrolledWindow. 可 以 有 滚动 条 的 窗口 . 
。 wxSplitterWindow. 可 以 管理 两 个 子 窗口 的 一 种 特殊 窗口 类 . 


非 静态 控件 窗口 类 
这 些 控 件 是 用 户 可 以 操作 或 者 编辑 的 。 


。 wxButton. 一 种 拥有 一 个 标签 的 按钮 控件 . 
。 wxBitmapButton. 一 种 拥有 图 片 和 标签 的 按钮 控件 . 
。 wxChoice. 拥有 一 个 下 拉 列 表 的 选择 控件 . 
。 WXComboBox. 拥有 一 组 选项 的 可 编辑 的 选择 控件 . 


wxCheckBox. 拥有 一 个 复 选 框 的 控件 ， 复 选 框 有 选中 和 未 选中 两 种 状态 . 
wxListBox. 拥有 一 组 可 选择 的 字符 串 项 目的 列表 框 . 

wxRadioBox. 拥有 一 组 选项 的 单 选 框 . 

wxRadioButton. 单 选 框 . 

wxScrollBar. 滚动 条 控件 。 

wxSpinButton. 一 个 拥有 增加 和 减 小 两 个 选项 的 按钮 . 

wxSpinCtrl. 拥有 一 个 文本 编辑 框 和 一 个 wxSpinButton 用 来 编辑 整数 . 
wxSlider. 这 个 控件 用 来 在 一 个 固定 的 范围 内 选择 一 个 整数 . 

wxTextCtrl. 单行 或 者 多 行 的 文本 编辑 框 . 

wxToggleButton. 两 态 按钮 . 


静态 控件 


这 些 控件 提供 不 能 被 最 终 用 户 编辑 的 静态 信息 


菜单 


wxGauge. 用 来 显 式 数量 的 控件 . 

wxStaticText. 文字 标签 控件 . 

wxStaticBitmap. 用 来 显示 一 幅 静 态 图 片 . 

wxStaticLine. 用 来 显 式 静 态 的 一 行 . 

wxStaticBox. 用 来 在 别 的 控件 周围 显示 一 个 静态 的 方 框 . 


菜单 是 一 种 包含 一 组 命令 列表 的 窗口 
控件 条 


控件 条 通常 在 Frame 窗 口中 使 用 ， 用 来 为 信息 或 者 命令 的 访问 提供 快捷 操作 


wxMenuBar wxFrame 上 的 菜单 条 . 
wxToolBar. 工具 条 . 
wxStatusBar. 状态 条 用 来 在 程序 运行 过 程 中 显示 运行 期 信息 . 


4.3 基础 窗口 类 


虽然 你 不 一 定 有 机 会 直接 使 用 基础 窗口 类 (wxWindow)， 但 是 由 于 这 个 类 是 很 多 窗口 控件 的 基 
类 ， 它 实现 的 很 多 方法 在 它 的 子 类 型 中 都 可 以 直接 拿 来 使 用 ， 所 以 有 必要 介绍 一 下 这 个 基础 
窗口 Re 


窗口 类 wxWindow 


wxWindow 窗 口 类 既是 一 个 重要 的 基 类 ， 也 是 一 个 你 可 以 直接 在 代码 中 使 用 的 类 。 当 然 ， 前 者 
使 用 的 频 度 要 比 后 者 大 很 多 。 


和 前 面 提 到 的 一 样 ，wxWindow 也 可 以 使 用 单 步 创建 或 者 两 步 创 建 两 种 方式 。 单 步 创 建 的 构造 
BURA TF : 


wxWindow(wxWindow* parent, 
wxWindowID id, 
const wxPoint& pos = wxDefaultPosition, 
const wxSize& size = wxDefaultSize, 
long style = 0, 
const wxString& name = wxT("panel")); 


可 以 象 下 面 这 样 使 用 : 


wxWindow* win = new wxWindow(parent, wxID_ANY, 
wxPoint(100, 100), wxSize(200, 200)); 


窗口 类 型 


每 一 个 窗口 类 都 可 以 使 用 定义 在 下 表 中 的 这 些 窗口 基 类 中 的 窗口 类 型 。 这 些 类 型 中 不 是 所 有 
的 类 些 都 被 所 有 的 控件 所 支持 。 例 如 对 于 边框 的 类 型 。 如 果 在 创建 窗口 的 时 候 你 没有 指定 窗 
口 的 边框 类 型 ， 那 么 在 不 同 的 平台 上 将 会 有 不 同 的 边框 类 型 的 缺 省 值 。 在 windows 平 台 上 ， 控 
件 边 框 的 缺 省 值 为 wxSUNKEN_BORDER, 意 为 使 用 当前 系统 风格 的 边框 。 你 可 以 使 用 类 似 
wxNO_BORDER 这 样 的 值 来 覆盖 系统 的 默认 值 。 


wxSIMPLE_BORDER 
wxDOUBLE_BORDER 
wxSUNKEN_BORDER 
wxRAISED_BORDER 


wxSTATIC_BORDER 
wxNO_BORDER 


wxTRANSPARENT_WINDOW 


wxTAB_TRAVERSAL 


wxWANTS_CHARS 


wxFULL_REPAINT_ON_RESIZE 


wxVSCROLL 
wxHSCROLL 


wxALWAYS_SHOW_SB 


wxCLIP_CHILDREN 


在 窗口 周围 显示 一 个 瘦 边 框 . 

显示 一 个 双 层 边框 . 

显示 一 个 凹陷 的 边框 ， 或 者 使 用 当前 窗口 风格 设置 . 
显示 一 个 凸 起 的 边框 . 

显示 一 个 适合 静态 控件 的 边框 . 只 支持 Windows 平 


人 
A. 


不 显示 任何 边框 . 


定义 一 个 透明 窗口 (意思 是 这 个 窗口 不 接收 paint 事 
件 ). 只 支持 windows 平 台 . 


使 用 这 个 类 型 允许 非 Dialog 窗 口 支 持 使 用 TAB 进行 通 
历 . 


使 用 这 个 类 型 来 允许 窗口 接收 包括 回 车 和 TAB 在 内 

的 所 有 的 键 瘟 事件 。TAB 用 来 在 Dialog 类 型 的 窗口 中 
通 历 各 控件 。 如 果 没 有 设置 这 个 类 型 ， 这 些 特殊 的 

按键 事件 将 不 会 被 产生 。 


在 默认 情况 下 ， 在 窗口 客户 区 大 小 发 生 改 变 时 ， 
wxWidgets 并 不 会 重 画 整个 客户 区 。 设 置 这 个 类 型 
将 使 得 wxWidgets 改 变 这 种 默认 的 作法 ， 而 保持 整 
个 客户 区 的 刷新 


显示 垂直 滚动 条 . 

显示 水 平 滚动 条 . 

如 果 一 个 窗口 有 滚动 条 ， 那 么 在 不 需要 滚动 条 的 时 
候 〈 当 窗口 足够 大 不 需要 使 用 滚动 条 的 时 候 ) , R 
止 滚 条 而 不 隐藏 滚动 条 。 这 个 类 型 目前 只 支持 
Windows 平 台 和 wxWidgets 的 wxUniversal 版 本 . 


只 支持 Windows 平 台 , 用 于 消除 由 于 擦 除 子 窗口 的 背 
Sm Sl RCA N Sh. 


下 表 列 出 了 窗口 的 扩展 类 型 ， 这 些 扩展 类 型 不 能 直接 和 类 型 混用 ， 而 要 使 用 


wxWindow::SetExtraStyle Ba AK #4 47 


设置 。 


wxWS_EX_VALIDATE_RECURSIVELY 


wxWS_EX_BLOCK_EVENTS 


wxWS_EX_TRANSIENT 


wxWS_EX_PROCESS_IDLE 


wxWS_EX_PROCESS_UI_UPDATES 


窗口 事件 


在 默认 情况 下 ， 
Validate,transferDataToWindow, 和 
transferDataFromWindow 只 在 窗口 的 直接 
子 窗口 上 才 可 以 使 用 。 如 果 设 置 了 这 个 扩展 
类 型 ， 那 么 将 可 以 递 为 的 在 各 个 子 窗口 上 使 
用 。 


wxCommandEvents 事 件 将 会 在 无 法 在 当前 
事件 表 中 找到 匹配 的 时 候 在 其 父 窗口 中 尝试 
匹配 ， 设 置 这 个 扩展 属性 可 以 阻止 这 个 行 
为 。Dialog 类 型 的 窗口 默认 设置 了 这 个 类 
型 ， 但 是 如 果 SetExtraStyle 被 应 用 程序 类 调 
用 过 的 话 ， 默 认 设置 可 能 被 覆盖 . 


不 要 使 用 这 个 窗口 作为 其 它 窗 口 的 父 窗 口 .这 
个 类 型 一 定 只 能 用 于 瞬间 窗口 ;否则 ， 如 果 使 
用 它 作为 一 个 dialog 或 者 fame 类 型 窗口 的 父 
窗口 ， 如 果 父 窗口 在 子 窗口 之 前 释放 ， 可 能 
SRRA R 


这 个 窗口 应 该 处 理 所 有 的 idle 事 件 ， 包 括 那 些 
设置 了 wxIDLE_PROCESS_SPECIFIED 模 
式 的 idle 事 件 。 


这 个 窗口 将 处 理 所 有 的 Ui 刷 新 事件 ， 包 括 那 
些 设 置 了 
wxUPDATE_UI_PROCESS_SPECIFIED 的 
UI 刷 新 事件 。 参 考 第 9 章 获 得 和 界面 刷新 有 关 
的 更 多 的 内 容 . 


窗口 类 和 它 的 派生 类 可 以 产生 下 面 的 事件 〈 鼠 标 ， 键 盘 和 游戏 手柄 产生 的 事件 将 会 在 第 6 章 描 


述 ) 。 


EVT_WINDOW_CREATE(func) 


EVT_WINDOW_DESTROY (func) 


EVT_PAINT(func) 


EVT_ERASE_BACKGROUND (func) 


EVT_MOVE(func) 


EVT_SIZE(func) 


EVT_SET_FOCUS(func)EVT_KILL_FOCUS(func) 


EVT_SYS_COLOUR_CHANGED(func) 


EVT_IDLE(func) 


EVT_UPDATE_UI(func) 


wxWindow # AYBK A EA 


用 于 义理 wxEVT_CREATE 事 件 , 这 
个 事件 在 窗口 刚刚 被 产生 的 时 候 生 
成 ， 人 处 理 函 数 的 参数 类 型 是 
wxWindowCreateEvent. 


用 于 处理 wxEVT_DELETE 事 件 , 在 这 
个 窗口 即将 被 删除 的 时 候 产 生 ， 钦 理 
PERMA BSN H Ale 
wxWindowDestroyEvent. 


用 于 人 处理 wxEVT_PAINT 事 件 , 在 窗口 
需要 被 刷新 的 时 候 产 生 . 处 理 范 数 的 
参数 类 型 是 wxPaintEvent. 


用 于 处 理 
wxEVT_ERASE_BACKGROUND 事 
件 , 在 窗口 背景 需要 被 更 新 的 时 候 产 
Æ. OT MMS eS 
wxEraseEvent. 


FAF 2 2wxEVT_ MOVES #4, 在 窗 
口 移动 的 时 候 产 生 . 处 理 范 数 的 参数 
类 型 是 wxMoveEvent. 


用 于 人 处理 wxEVT_SIZE 事 件 , 在 窗口 
大 小 发 生变 化 以 后 产生 .人 处理 函数 的 
参数 类 型 是 wxSizeEvent. 


用 于 处理 wxEVT_SET_FOCUS 和 
wxEVT_KILL_FOCUS 事 件 ,在 窗口 得 


理 函 数 参 数 类 型 是 wxFocusEvent. 


用 于 处 理 

wxEVT_SYS_COLOUR_ CHANGED 
事件 , 当 用 户 在 控制 面板 里 更 改 了 系 
统 颜 色 的 时 候 产 生 ( 只 支持 windows 
平台 ). 处 理 画 数 参 数 类 型 为 
wxSysColourChangedEvent. 


用 于 处理 wxEVT_IDLE 事 件 , 在 空闲 
事件 产生 .处 理事 数 参 数 类 型 位 
wxldleEvent. 


用 于 人 处理 wxEVT_UPDATE_U| 事 件 ， 
在 系统 空间 时间 产生 用 来 给 窗口 一 个 
更 新 自己 的 机 会 . 


因为 wxWindow 类 是 其 它 所 有 窗口 类 的 基 类 ， 它 拥有 很 多 的 成 员 画 数 。 我 们 不 可 能 在 这 里 作 一 
一 的 说 明 ， 只 能 栋 其 中 最 重要 的 一 些 作 简要 的 说 明 。 不 过 我 们 还 是 推荐 你 浏览 一 下 wxWidgets 
手册 中 的 相关 部 分 ， 以 便 能 够 彻底 了 解 wxWindow 类 提供 的 所 有 功能 ， 以 及 要 使 用 这 个 功能 你 


需要 提供 的 参数 等 。 


CaptureMouse 画 数 可 以 捕获 所 有 的 鼠标 输入 〈 将 其 限制 在 本 窗口 以 内 ) ,ReleaseMouse 则 可 
以 释放 前 一 次 的 捕获 .在 绘图 程序 中 ， 这 两 个 范 数 是 很 有 用 的 。 它 可 以 让 你 在 鼠标 移动 到 窗口 
边缘 的 时 候 来 滚动 窗口 的 客户 区 ， 而 不 是 任 由 鼠标 跑 到 别 的 窗口 并 且 激活 别 的 窗口 。 另 外 的 
两 个 函数 GetCapture 用 来 获取 当前 正在 使 用 的 捕获 设备 (如 果 是 被 当前 的 应 用 程序 设置 的 话 )， 
而 HasCapture 可 以 用 来 检测 是 否 鼠 标 正 被 这 个 窗口 捕获 。 


Centre, CentreOnParent 和 CentreOnScreen 三 个 函数 可 以 让 窗口 调整 自己 的 位 置 使 其 位 于 屏 
幕 或 者 是 其 父 窗口 的 正中 间 位 置 。 


ClearBackground 画 数 将 使 用 当前 的 背景 色 清 除 当 前 窗口 . 


ClientToScreen 和 ScreenTocClient 可 以 将 座 标 在 相对 于 屏幕 大 上 角 和 相对 于 客户 区 左上 角 之 间 
进行 互相 转换 . 


Close 2x = 4 —~SwxCloseEvent#44, XPS) RN XBYRERADEO, BAe 4 
然 如 果 应 用 程序 为 这 个 事件 定义 了 特殊 的 义理 函数 ， 那 么 窗口 也 有 可 能 不 被 关闭 和 释放 。 


ConvertDialogToPixels 和 ConvertPixelsToDialog 函 数 可 以 对 数值 进行 对 话 框 单位 和 和 象 素 单位 
之 间 的 转换 。 这 在 基于 字体 大 小 以 便 应 用 程序 的 显示 更 合理 的 操作 中 是 很 有 用 的 . 


Destroy 画 数 将 安全 的 释放 窗口 .使 用 这 个 画 数 代 蔡 直接 调用 delete 操 作 符 因为 这 个 画 数 下 不 同 
的 窗口 类 型 的 表现 是 不 一 样 的 。 对 于 对 话 框 和 frame 这 样 的 顶层 窗口 来 说 ， 这 个 画 数 会 将 窗口 
放 入 一 个 等 待 删除 的 额 窗 口 列 表 中 ， 等 到 这 个 窗口 的 所 有 的 事件 都 处 理 完 毕 的 时 候 才 会 被 删 
除 ， 这 可 以 避免 一 些 事件 在 已 经 不 存在 的 窗口 上 被 执行 . 


Enable 人 允许 或 者 禁止 窗口 和 它 的 子 窗口 处 理 输入 事件 。 在 禁止 状态 下 一 些 窗口 会 有 不 同 的 颜 
色 和 人 外观 。Disable 函 数 和 Enable 函 数 使 用 false 作 为 参数 的 效果 是 完全 一 样 的 。 


FindFocus 辑 数 是 一 个 静态 画 数 ， 用 它 可 以 找到 当前 拥有 键 胡 焦点 的 窗口 。 


FindWindow 画 数 可 以 通过 标识 符 或 者 名 字 在 它 的 窗口 关系 树 中 寻找 某 个 窗口 . 返回 值 可 能 
它 的 一 个 子 窗口 或 者 它 自己 .如 果 你 可 以 确定 你 要 找 的 窗口 的 类 型 ， 可 以 安全 的 使 用 
WwWXxDynamicCast 进 行 类 型 强制 转换 ， 转 换 的 结果 将 是 一 个 指向 那个 类 型 的 指针 或 者 是 NULL: 


MyWindow* window = wxDynamicCast(FindWindow(ID_MYWINDOW), MyWindow); 


Fit 本 数 会 自动 改变 窗口 的 大 小 以 便 刚 好 可 以 容纳 它 的 所 有 子 窗口 .这 个 函数 应 用 被 应 用 在 使 用 
基于 sizer 的 布局 的 时 候 。Fitlinside 画 数 是 一 个 类 似 的 函数 ， 区 别 在 于 它 使 用 的 是 虚 大 小 (占用 
在 那些 包含 滚动 条 的 窗口 ). 


Freeze 和 Thaw， 这 两 个 图 数 的 作用 是 告诉 wxWidgets， 在 这 两 个 孙 数 之 间 进 行 的 刷新 界面 的 
操作 是 允许 被 优化 的 。 举 例 来 说 ， 如 果 你 要 在 一 个 文本 框 控件 逐 行 中 加 入 多 行文 本 ， 则 可 以 
用 这 个 方法 来 优化 显示 效果 ， 避 免 闪烁 ， 这 两 个 图 数 已 经 在 GTK+ 版 本 的 wxTextCtrl 控 件 上 实 
现 ， 也 适用 于 Windows 和 Max Os X 平 台 的 所 有 类 . 


GetAcceleratorTable 和 SetAcceleratorTable 用 来 获取 和 设置 某 个 窗口 的 加 速 键 表 . 


GetBackgroundColour 和 SetBackgroundColour 用 来 访问 窗口 的 背景 颜色 属性 。 这 个 属性 被 
wxEVT_ERASE_BACKGROUND 事 件 用 来 绘制 窗口 背景 .如 果 你 更 改 了 背景 颜色 设置 ， 你 应 
该 调用 Refresh 或 者 ClearBackground al #1 & ==. SetOwnBackgroundColour 的 作用 和 
SetBackgroundColour 基 本 相同 ， 但 是 前 者 不 会 更 改 当 前 窗口 的 子 窗口 的 背景 属性 . 


GetBackgroundStyle 和 SetBackgroundStyle 用 来 设置 窗口 的 背景 类 型 . 默认 的 窗口 背景 类 型 是 
wxBG_STYLE_SYSTEM, 它 的 含义 是 wxWidgets 按 照 系统 默认 设置 来 进行 背景 绘制 。 系 统 默 
认 的 背景 绘制 方法 根据 控件 的 不 同 而 不 同 ， 上 比如 wxDialog 的 默认 背景 绘制 方法 是 什么 纹理 绘 
制 的 方法 ， 而 wxListBox 则 是 使 用 固定 颜色 的 绘制 方法 。 如 果 你 设置 了 窗口 的 背景 绘制 方法 类 
型 是 wxBG_STYLE_COLOUR, 那 么 wxWidgets 会 全 部 用 单一 颜色 的 方法 绘制 背景 。 而 如 果 你 
将 其 设置 为 wxBG_STYLE_CUSTOM, wxWidgets 将 不 进行 任何 的 背景 绘制 工作 ， 你 可 以 自己 
在 擦 除 背 景 事件 中 或 者 重 画 事件 中 自己 绘制 背景 .如 果 你 希望 自己 绘制 背景 ， 请 一 定 设置 
wxBG_STYLE_CUSTOM 为 背景 类 型 ， 否 则 很 容易 引起 画面 的 闪烁 . 


GetBestSize 函 数 以 象 素 为 单位 返回 窗口 最 合适 的 大 小 (因为 每 个 窗口 类 都 需要 实现 
DoGetBestSize 画 数 ). 这 个 函数 用 来 提示 Sizer 系 统 不 要 让 这 个 窗口 的 尺寸 太 小 以 致 不 能 正确 的 
显示 和 使 用 。 举 例 来 说 ， 对 于 静态 文本 控件 来 说 ， 不 要 让 它 的 字符 只 能 显示 一 半 。 对 于 包含 
其 它 子 窗口 的 窗口 比如 wxPanel 来 说 ， 这 个 尺寸 等 于 对 这 个 窗口 调用 Fit 函 数 以 后 的 尺寸 的 大 


小 


o 


GetCaret 和 SetCaret 函 数 用 来 访问 或 者 设置 窗口 的 光标 . 


GetClientSize 和 SetClientSize 用 来 访问 和 设置 窗口 的 客户 区 大 小 ， 单 位 是 象 素 . 客户 区 大 小 指 
的 是 不 包括 边框 和 修饰 的 区 域 ， 或 者 说 你 用 户 可 以 绘制 或 者 用 来 放置 子 窗口 的 区 域 . 


GetCursor 和 SetCursor 函 数 用 来 访问 和 设置 窗口 的 妃 标 指针 . 


GetDefaultltem 函 数 返 回 一 个 指向 这 个 窗口 默认 的 子 按钮 的 指针 或 者 返回 NULL。 默 认 子 按钮 
是 当 用 户 按 回 车 键 的 时 候 默 认 激活 的 按钮 ， 可 以 通过 WxButton::SetDefault 函 数 进行 设置 . 


GetDropTarget 和 SetDropTarget 函 数 用 来 取得 或 者 设置 和 窗口 关联 的 wxDropTarget 对 象 ， 这 
个 对 象 用 来 处 理 和 控制 窗口 的 拖 放 操 作 . 我 们 将 在 第 11 章 "剪贴 板 和 拖 放 "中 详细 介绍 拖 放 有 关 
的 操作 。 


GetEventHandler 和 SetEventHandler 函 数 用 来 访问 和 设置 窗口 的 第 一 事件 表 . 默 认 情 况 下 ， 窗 
口 的 事件 表 就 是 窗口 自己 ， 但 是 你 可 以 指定 不 同 的 事件 表 ， 也 可 以 通过 PushEventHandler 和 

PopEventHandler 琅 数 设 置 一 个 事件 表 链 。 然 后 让 不 同 的 事件 表 处 理 不 同 的 事件 . wxWidgets 

将 搜索 整个 事件 表 链 来 寻找 匹配 的 事件 处 理 函 数 处 理 新 收 到 的 事件 ， 详 情 请 参阅 第 3 章 ，“ 事 件 
处 理 ”. 


GetExtraStyle 和 SetExtraStyle 函 数 用 来 获取 和 设置 窗口 的 扩展 类 型 位 。 扩 展 类 型 宏 通 常 以 
wxWSEXF &. 


GetFont 和 SetFont 函 数 获 取 和 设置 和 窗口 相关 的 字体 . SetOwnFont 和 SetFont 的 功能 相似 , 唯 
一 的 区 别 在 于 前 者 设置 的 字体 不 会 被 子 窗口 继承 . 


GetForegroundColour 和 SetForegroundColour 函 数 用 来 操作 窗口 的 前 景 颜 色 属 性 . 和 
SetOwnForegroundColour 范 数 的 区 别 仅 在 于 是 否 改变 子 窗口 的 这 个 属性 。 


GetHelpText 和 SetHelpText 用 来 获取 和 设置 窗口 相关 的 上 下 文 帮助 .这 个 文本 属性 实际 上 存储 
在 当前 的 wxHelpProvider 实 现 中 ， 而 不 是 存在 于 窗口 类 中 . 


Getld 和 Setld 用 来 操作 窗口 标识 符 . 
GetLabel 范 数 返 回 窗 口 相 关联 的 标签 .具体 的 含义 取决 的 特定 的 窗口 类 . 


GetName 和 SetName 用 来 操作 窗口 名 称 ,这 个 名 字 不 需要 是 唯一 的 。 这 个 名 称 对 wxWidgets 来 
说 没有 什么 意义 ,但 是 在 Motif 系 统 中 被 用 于 窗口 资源 的 名 称 . 


GetParent 返 回 窗口 的 父 窗口 . 
GetPosition 以 象 素 单位 返回 相对 于 父 窗口 的 窗口 左上 角 座 标 。 


GetRect 返 回 一 个 wxRect 对 象 (参考 第 13 章 , "数据 结构 和 类 型 "), 其 中 包含 了 象 素 单位 的 这 个 窗 
口 的 大 小 和 位 置信 息 . 


GetSize 和 SetSize 函 数 获取 和 设置 窗口 象 素 单 位 的 窗口 长 宽 . 
GetSizer 和 SetSizer 函 数 用 来 操作 这 个 窗口 绑 定 的 最 顶级 的 窗口 布局 对 象 . 
GetTextExtent 用 于 返回 当前 字体 下 某 个 字符 串 的 象 素 长 度 . 
GetToolTip 和 SetToolTip 用 来 操作 这 个 窗口 的 tooltip 对 象 . 

GetUpdateRegion 函 数 返 回 窗口 自 上 次 Paint 事 件 以 来 需要 刷新 的 区 域 . 
GetValidator 和 SetValidator 函 数 用 来 操作 这 个 窗口 可 选 的 wxValidator 对 象 。 详 情 请 参考 第 9 章 . 
GetVirtualSize 返 回 窗口 的 虚 大 小 ， 通 常 就 是 和 滚动 条 绑 定 的 那个 大 小 . 
GetWindowStyle 和 SetWindowStyle 用 来 操作 窗口 类 型 比特 位 。 

InitDialog 函 数 发 送 一 个 wxEVT_INIT_DIALOG 事 件 来 来 开始 对 话 框 数据 传送 
IsEnabled 用 来 检测 当前 窗口 的 使 能 状态 . 

lsSExposed 用 来 检测 一 个 点 或 者 一 个 矩形 区 域 是 否 位 于 需要 刷新 的 范围 。 
lsShown 用 来 指示 窗口 是 否 可 见 . 

lsTopLevel 用 来 指示 窗口 是 否 是 顶层 窗口 ( 仅 用 于 wxFrame 或 者 wxDialog). 
Layout 画 数 用 来 在 窗口 已 经 指定 一 个 布局 对 象 的 情况 下 更 新 窗口 布局 。 参 考 第 7 章 . 


Lower 豆 数 用 来 将 窗口 移 到 窗口 树 的 最 低 吓 ， 而 Raise 则 把 窗口 移动 到 窗口 树 的 最 顶层 .这 两 个 
函数 既 可 以 用 于 顶层 窗口 ， 也 可 以 用 于 子 窗口 . 


MakeModal 辑 数 禁 用 其 它 所 有 的 顶层 窗口 ， 以 便 用 户 只 能 和 当前 这 个 顶层 窗口 交互 . 
Move 函 数 用 来 移动 窗口 . 


MoveAfterlnTabOrder 更 改 窗口 的 TAB 顺序 到 作为 参数 的 窗口 的 后 面 , 而 
MoveBeforelnTabOrder 则 将 其 挪 到 参数 窗口 的 前 面 . 


PushEventHandler 太 入 一 个 事件 表 到 当前 的 事件 表 栈 , PopEventHandlerfy 24% H # Ak eS 
件 表 栈 最 顶层 的 事件 表 . RemoveEventHandler 则 查找 事件 表 栈 中 的 一 个 事件 表 并 且 将 其 出 栈 . 


PopupMenu 画 数 在 某 个 位 置 弹 出 一 个 菜单 . 

Refresh 和 RefreshRect 画 数 导致 窗口 收 到 一 个 重 画 事件 (和 一 个 可 选 的 擦 除 背 景 事件 ). 
SetFocus HŽ A AME A ra. 

SetScrollbar KHR FAK z E i O AER ab RIRE 


SetSizeHints HA AKE LAORDRART, RRAOR TISZA D, Lome an 
用 . 


Show 男 数 用 来 显示 和 隐藏 窗口 ; Hide 函 数 的 作用 相当 于 适用 false 作 为 参数 调用 Show 函 数 . 


transferDataFromWindow 和 transferDataToWindow 获 取 和 传输 数据 到 窗口 对 象 ， 并 且 在 没有 
被 重 载 的 情况 下 会 调用 验证 本 数 . 


Update 立 即 重 画 窗口 已 经 过 期 的 区 域 . 


UpdateWindowUI 画 数 发 送 wxUpdateUIEvents 事 件 到 窗口 ， 以 便 给 窗口 一 个 更 新 窗口 元 素 
(比如 工具 条 和 菜单 ) 的 机 会 . 


Validate 使 用 当前 的 验证 对 象 验证 窗口 数据 . 
WXControl 类 


wxControl 是 一 个 虚 类 。 它 继承 自 wxWindow， 用 来 作为 控件 的 基 类 : 所 谓 控 件 指 的 是 那些 可 以 
显示 数据 项 并 且 通 常 需要 响应 鼠标 或 者 键盘 事件 的 那些 窗口 类 . 


wxControlWithltems 类 


WxControlWithltems 也 是 一 个 虚 类 ， 用 来 作为 wxWidgets 的 一 些 包含 多 个 数据 项 的 控件 (比如 
wxListBox, wxCheckListBox,wxChoice 和 wxComboBox 等 ) 的 基 类 。 使 用 这 个 基 类 的 目的 为 
了 给 这 些 具 有 相似 功能 的 控件 提供 一 致 的 API 函 数 。 


wxControlWithltems 的 数据 项 拥有 一 个 字符 串 和 一 个 和 这 个 字符 串 绑 定 的 可 选 的 客户 数据 。 客 
户 数据 可 以 是 两 种 类 型 ， 要 么 是 无 类 型 指针 (void*), 这 意味 这 这 个 控件 只 帮忙 存储 客户 数据 但 
是 永远 不 会 使 用 客户 数据 。 另 外 一 种 是 有 类 型 (wxClientData) 指针 ,对 于 后 一 种 情况 ， 客 户 
数据 会 在 控件 被 释放 或 者 数据 项 被 清除 的 时 候 被 自动 释放 。 同 一 个 控件 的 所 有 数据 项 必须 拥 
有 同样 的 客户 区 数据 类 型 : 要 么 是 前 者 ， 要 么 是 后 者 。 客 户 区 数据 的 类 型 是 在 第 一 次 调用 


Append Xk, SetClientDatak ex SetClientObjectH AN x RRA ER, MRE 
有 类 型 指针 客户 数据 ， 你 应 该 自 定义 一 个 继承 自 wxClientData 的 类 ， 然 后 将 它 的 实例 指针 传递 
Append MX SetClientObjectEH 2X. 


wxControlWithltemsAY AX A RIŽ 


Appendix A 3x M248 1—- TA — meen. 如 果 是 增加 一 个 数据 项 ， 你 可 以 用 第 二 
参数 指定 比如 : 


wxArrayString strArr; 

strArr.Add(wxT("First string")); 

strArr.Add(wxT("Second string")); 
controlA->Append(strArr); 

controlA->Append(wxT("Third string")); 
controlB->Append(wxT("First string"), (void *) myPtr); 
controlC->Append(wxT("First string"), new MyTypedData(1)); 


Clear BUA PRE H+ Ara SHE mF BSR BNE P SHE. 
Delete 函 数 使 用 基于 0 的 索引 清除 一 个 数据 项 以 及 它 的 客户 数据 。 
FindString 返 回 一 个 和 某 个 字符 串 基于 0 的 数据 项 的 索引 。 如 果 找 不 到 则 返回 wxNOT_FOUND. 


GetClientData 和 GetClientObject 返 回 某 个 数据 项 的 客户 区 数据 指针 (如 果 有 的 话 ). 
SetClientData 和 SetClientObject 则 可 以 用 来 设置 这 个 指针 . 


GetCount 数 据 项 的 总 数 . 


GetSelection 返 回 选 中 的 数据 项 或 wxNOT_FOUND. SetSelection 则 用 来 设置 某 个 数据 项 为 选 
中 状态 . 


GetString 用 来 获取 某 个 数据 项 的 字符 串 ; SetString 则 用 来 设置 


GetStringSelection 用 来 返回 选中 的 数据 项 的 字符 串 或 者 一 个 空 的 字符 串 ; SetStringSelection 
则 用 来 设置 选中 的 字符 串 。 你 应 该 先 调用 FindString 函 数 保证 这 个 字符 串 是 存在 于 某 个 数据 项 
的 ， 否 则 可 能 引发 断言 失败 . 


Insert 在 控件 数据 项 的 某 个 位 置 插入 一 个 数据 项 (可 以 包含 也 可 以 不 包含 客户 数据 ). 
lIsEmpty 则 用 来 检测 一 个 控件 的 数据 项 是 否 为 空 . 


4.4 顶层 窗口 


顶层 窗口 直接 被 放置 在 桌面 上 而 不 是 包含 在 其 它 窗口 之 内 。 如 果 应 用 程序 允许 ， 他 们 可 以 被 
移动 或 者 重新 改变 大 小 。 总 共有 三 种 基础 的 顶层 窗口 类 型 。 wxFrame 和 wxDialog 都 是 从 一 个 
虚 类 wxTopLevelWindow 继 承 来 的 。 另 外 一 个 wxPopupWindow 功 能 相对 简单 ， 是 直接 从 
wxWindow 继 承 过 来 的 。 一 个 dialog 既 可 以 是 模式 的 也 可 以 是 非 模式 的 ， 而 frame 通 常 都 是 非 
模式 的 。 模 式 对 话 框 的 意思 是 说 当 这 个 对 话 框 弹 出 时 ， 频 用 程序 除了 等 待 用 户 关 闭 这 个 对 话 
框 以 外 不 再 作 别 的 事情 。 对 于 那些 要 等 待 用 户 响应 以 后 才能 继续 的 操作 来 说 。 这 是 比较 合适 
的 。 但 是 寻找 替代 的 解决 方案 通常 也 不 是 一 件 坏事 。 举 例 来 说 ， 在 工具 条 上 设置 一 个 字体 选 
项 可 能 比 弹 出 一 个 模式 的 对 话 框 让 用 户 选择 字体 更 能 是 整个 应 用 程序 看 上 去 更 流畅 。 


顶层 窗口 通常 都 拥有 一 个 标题 栏 ， 这 个 标题 栏 上 有 一 些 按钮 或 者 菜单 或 者 别 的 修饰 用 来 关 
闭 ， 或 者 最 小 化 ， 或 者 恢复 这 个 窗口 。 而 frame 窗 口 则 通常 还 会 拥有 菜单 条 ， 工 具 条 和 状态 
条 。 但 是 通常 对 话 框 则 没有 这 些 。 在 Mac OS X 上 ，frame 窗 口 的 菜单 条 通常 不 是 显示 在 frame 
窗口 的 顶部 而 是 显示 在 整个 屏幕 的 顶部 。 


不 要 被 "顶层 窗口 "的 叫 法 和 wxApp::GetTopWindow 郴 数 给 摘 糊 涂 了 。wxWidgets 使 用 后 者 来 得 
到 应 用 程序 的 主 窗 口 ， 这 个 主 窗口 通常 是 你 在 应 用 程序 里 创建 的 第 一 个 fame 窗 口 或 者 dialog 
窗口 。 


如 果 需 要 ， 你 可 以 使 用 全 局 变量 wxTopLevelWindows 来 访问 所 有 的 顶层 窗口 ， 这 个 全 局 变量 
是 一 个 wxWindowList 类 型 . 


wxFrame 


wxFrame 是 主 应 用 程序 窗口 的 一 个 通用 的 选择 。 下 图 演示 了 常见 的 各 个 frame 窗 口 元 素 。 
frame 窗 口 拥有 一 个 可 选 的 标题 栏 (上 面 有 一 些 类 似 关闭 功能 的 按钮 ) ， 一 个 菜单 条 ， 一 个 工 
具 栏 ， 一 个 状态 栏 。 剩 下 的 区 域 则 称 为 客户 区 ， 如 果 拥 有 超过 一 个 子 窗口 ， 那 么 他 们 的 尺寸 
和 位 置 是 由 应 用 程序 决定 的 。 你 应 该 通过 第 7 章 中 会 讲 到 的 窗口 布局 控件 来 作 相关 的 事情 。 或 
者 如 果 只 有 两 个 子 窗口 的 话 ， 你 可 以 考虑 使 用 一 个 分 割 窗 口 。 后 者 我 们 稍 后 就 会 讲 到 。 
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在 某 些 平台 上 不 允许 直接 绘制 fame 窗 口 ， 因 此 你 应 该 增加 一 个 wxPanel 作 为 容器 来 放置 别 的 
子 窗口 控件 ， 以 便 可 以 通过 键 瘟 来 通 历 各 个 控件 。 


frame 窗 口 是 允 许 包含 多 个 工具 条 的 ， 但 是 它 只 会 自动 放置 第 一 个 工具 条 。 因 此 你 需要 自己 明 
确 的 布局 另外 的 工具 条 。 


你 很 点 该 基于 wxFrame 实 现 你 自己 的 frame 类 而 不 是 直接 使 用 wxFrame 类 ， 并 且 在 其 构造 画 数 
中 创建 自己 的 菜单 条 和 子 窗口 。 这 会 让 你 更 方便 处 理 类 似 wxEVT_CLOSE 事 件 和 别 的 命令 事 
件 。 


你 可 以 给 frame 窗 口 指定 一 个 图 标 以 便 让 系统 显示 在 任务 栏 上 或 者 文件 管理 器 中 。 在 windows 
平台 上 ， 你 最 好 指定 一 组 16x16 和 32x32 并 且 拥 有 不 同 颜 色 深 度 的 图 标 。 在 linux 平 台 上 也 一 
样 ，windows 系 统 上 的 图 标 已 经 足够 。 而 在 Max OsX 上 ， 你 需要 更 多 的 不 同 颜 色 和 深度 的 图 
标 。 关 于 图 标 和 图 标 列表 的 更 多 信息 ， 可 以 参考 第 10 章 ，T 妈 在 应 用 程序 中 使 用 图 片 TI。 


除了 默认 的 构造 画 数 以 外 ，wxFrame 还 拥有 下 面 的 构造 画 数 


wxFrame(wxWindow* parent, wxWindowID id, const wxString& title, 
const wxPoint& pos = wxDefaultPosition, 
const wxSize& size = wxDefaultSize, 
long style = wxDEFAULT_FRAME_STYLE, 
const wxString& name = wxT("frame")); 


例如 : 


wxFrame* frame = new wxFrame(NULL, ID_MYFRAME, 
wxT( "Hello wxWidgets"), wxDefaultPosition, 
wxSize(500, 300)); 

frame->Show(true); 


ERE E AAAA Show, frameezheREnN, DER ABP AMASEMAN 
子 窗口 还 没有 被 显示 的 时 候 进 行 窗口 布局 。 


没有 必要 给 这 个 新 建 的 fame 窗 口 指 定 父 窗口 。 如 果 指 定 了 父 窗口 并 且 指 定 
Gide a 型 位 ， 这 个 新 建 的 窗口 将 会 显示 在 Ge 口 的 上 层 。 


要 删除 一 个 frame 窗口 ， 应 该 使 用 Destroy 方 法 而 不 是 使 用 delete 操 作 符 ， 因 为 Destroy 会 在 处 
理 完 这 个 窗口 的 所 有 事件 以 后 才 真 正 释 放 这 个 窗口 。 调 用 Close 画 数 会 导致 这 个 窗口 收 到 
wxEVT_CLOSE 事 件 ， 这 个 事件 默认 的 行为 是 调用 Destroy 方 法 。 当 一 个 ffame 窗 口 被 释放 
时 。 它 的 所 有 的 子 窗口 都 将 被 释放 ， 谁 叫 他 们 自己 不 是 顶层 窗口 呢 。 


当 最 后 一 个 顶层 窗口 被 释放 的 时 候 ， 应 用 程序 就 退出 了 (这 种 默认 的 行为 可 以 通过 调用 
wxApp:: SetExitOnFrameDelete 改 变 ) 。 你 应 该 在 你 的 主 窗 口 的 wxEVT_CLSE 事 件 义理 函数 
中 调用 Destroy 释 放 其 它 的 顶层 窗口 (比如 一 个 查找 对 话 框 之 类 ) ， 否 则 可 能 出 现 主 窗口 已 经 
关闭 但 是 应 用 程序 却 不 退出 的 情况 。 


ame aA E dalio A ialog howModal aaa 人 其 它 J 

消息 ， 然 后 ， 还 是 可 以 通过 别 的 方法 达到 类 似 的 目的 。 一 个 方法 是 通过 创建 一 

wxWindowDisabler 对 象 ， 另 外 一 个 方法 是 通过 wxModalEventLoop 对 象 ， a Sean 

的 指针 作为 参数 ， 然 后 调用 Run 画 数 开 始 一 个 本 地 的 事件 循环 ， 然 后 调用 Exit 函 数 (通常 是 在 
这 个 Frame 窗 口 的 某 个 事件 处 理 函 数 里 ) 退出 这 个 循环 。 


下 图 演示 了 一 个 用 户 应 用 程序 的 frame 窗 口 在 windows 上 运行 的 样子 。 这 个 frame 窗 口 拥有 一 
个 标题 栏 ， 一 个 菜单 条 ， 一 个 五 彩 的 工具 栏 ， 在 frame 窗 口 的 客户 区 有 个 分 割 窗口 ， 底 端 有 一 
个 状态 条 ， 正 显示 着 当 用 户 的 鼠标 划 过 工具 条 上 的 按钮 或 者 菜单 项 的 时 候 显 示 的 提示 。 
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wxFrame 的 窗口 类 型 比特 位 


Frame 窗 口 比 起 基本 窗口 类 ， 增 加 了 下 面 一 些 类 型 : 


wxDEFAULT_FRAME_STYLE 


wxICONIZE 
wxCAPTION 
wxMINIMIZE 


wxMINIMIZE_BOX 
wxMAXIMIZE 
wxMAXIMIZE_BOX 
wxCLOSE_BOX 


wxSTAY_ON_TOP 


wxSYSTEM_MENU 
wxRESIZE_BORDER 


wxFRAME_TOOL_WINDOW 


wxFRAME_NO_ TASKBAR 


wxFRAME_FLOAT_ON_PARENT 


wxFRAME_SHAPED 


其 值 为 wxMINIMIZE_BOX | wxMAXIMIZE_BOX | 
wxRESIZE_BORDER | wxSYSTEM_MENU | 
wxCAPTION | wxCLOSE_BOX. 


以 最 小 化 的 方式 显示 窗口 。 目 前 只 适用 于 Windows 
YT7 -人 
oo. 


在 窗口 上 显示 标题 . 


和 wxICONIZE 的 意义 相同 . 也 只 适用 于 Windows 平 
PER 


a. 
显示 一 个 最 小 化 按钮 . 

以 最 大 化 方式 显示 窗口 . 仅 适用 于 Windows. 
在 窗口 上 显示 最 大 化 按钮 . 

在 窗口 上 显示 关闭 按钮 . 


这 个 窗口 显示 在 其 它 所 有 顶层 窗口 之 上 . 仅 适 用 于 
Windows. 


显示 系统 菜单 . 
边框 可 改变 大 小 . 


窗口 的 标题 栏 比 正常 情况 要 小 ， 而 且 在 windows 平 
台 上 ， 这 个 窗口 不 会 在 任务 栏 上 显示 . 


创建 一 个 标题 栏 是 正常 大 小 ， 但 是 不 在 任务 栏 显 示 
的 窗口 。 目 前 支持 windows 和 linux。 需要 注意 在 
windows 平 台 上 ， 这 个 窗口 最 小 化 时 将 会 最 小 化 到 
桌面 上 ， 这 有 时 候 会 让 用 户 觉得 不 习惯 ， 因 此 这 种 
类 型 的 窗口 最 好 不 要 使 用 wxMINIMIZE_BOX 类 型 。 
拥有 这 种 类 型 的 窗口 总 会 显示 在 它 的 父 窗口 的 上 
层 。 使 用 这 种 类 型 的 窗口 必须 拥有 非 空 父 窗口 ， 否 
则 可 能 引发 断言 错误 . 


拥有 这 种 类 型 的 窗口 可 以 通过 调用 SetShape 函 数 来 
使 其 呈现 不 规则 窗口 外 貌 . 


下 表 列 出 的 是 frame 窗 口 的 扩展 类 型 ， 需 要 使 用 wxWindow::SetExtraStyle 函 数 才 可 以 设置 扩 
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在 windows 平 台 上 ， 这 个 扩展 类 型 导致 标题 栏 增加 
一 个 帮助 按钮 。 当 这 个 按钮 被 点 击 以 后 ， 窗 口 会 进 
入 一 种 上 下 文 帮助 模式 。 在 这 种 模式 下 ， 任 何 应 用 
程序 被 点 击 时 ， 将 会 发 送 一 个 wxEVT_HELP 事 件 。 


在 Mac OS X 平 台 上 ,这 个 扩展 类 型 将 会 导致 窗口 使 
用 金属 外 观 。 请 小 心 使 用 这 个 扩展 类 型 ， 因 为 它 可 
Cee A ME PAE 能 会 假定 你 的 应 用 程序 用 户 默认 安装 类 声卡 之 类 的 


多 媒体 设备 。 


wxFRAME_EX_CONTEXTHELP 


wxFrame 的 事件 
下 表 列 出 了 frame 窗 口 比 基本 窗口 类 增加 的 事件 类 型 : 


用 来 处 理 wxEVT_ACTIVATE 事 件 , 在 frame 窗 口 被 激活 或 者 去 
激活 的 时 候 产 生 . 人 处 理 函 数 的 参数 类 型 为 wxActivateEvent. 


用 来 处理 wxEVT_CLOSE 事 件 , 在 应 用 程序 准备 关闭 窗口 的 时 
EVT_CLOSE(func) 候 产 生 . TEENS k BY EwxCloseEvent. ix #* HH 
Veto 画 数 调用 以 阻止 这 个 事件 的 进一步 处 理 . 


用 来 处 理 wxEVT_ICONIZE 事 件 , 当 窗 口 被 最 小 化 或 者 被 恢复 普 
EVT_ICONIZE(func) 通 大 小 的 时 候 产 生 . 人 处 理 画 数 的 参数 类 型 为 wxlconizeEvent. 通 
过 使 用 lslconized 男 数 来 判断 究竟 是 最 小 化 事件 还 是 恢复 事件 . 


用 来 处 理 wxEVT_MAXIMIZE 事 件 , 当 窗口 被 最 大 化 或 者 从 最 大 
化 恢复 的 时 候 产 生 . 义理 函数 的 参数 类 型 为 wxXMaximizeEvent. 
通过 IsMaximized 丁 数 判断 究 竟 是 最 大 化 还 是 从 最 大 化 状态 恢 


EVT_ACTIVATE(func) 


EVT_MAXIMIZE(func) 


wxFrameMJAK j EIZ 


下 面 将 介绍 wxFrame 类 的 主要 的 成 员 函 数 。 因 为 wxFrame 类 是 从 wxTopLevelWindow 和 
wxWindow 继 承 过 来 的 ， 请 同样 参考 这 两 个 类 的 成 员 丁 数 。 


CreateStatusBar 函 数 在 frame 窗 口 的 底部 创建 一 个 拥有 一 个 或 多 个 域 的 状态 栏 . 可 以 使 用 
SetStatusText 范 数 来 设置 状态 栏 上 的 文字 ,使 用 SetStatusWidths 函 数 来 设置 状态 栏 每 个 域 的 宽 
度 ( 参 考 本 章 稍 后 对 wxStatusBar 的 介绍 ). 使 用 举例 : 


frame->CreateStatusBar(2, wxST_SIZEGRIP); 
int widths[3] = { 100, 100, -1 }; 
frame->SetStatusWidths(3, widths); 
frame->SetStatusText(wxT("Ready"), 0); 


CreateToolBar 函数 在 frame 窗 口 的 菜单 条 下 创建 一 个 工具 栏 . 当然 你 也 可 以 直接 创建 一 个 
wxToolBar 实 例 ， 然 后 调用 wxFrame::SetToolBar 函 数 以 便 让 frame 类 来 管理 你 刚 创建 的 
toolbar. 


GetMenuBar 用 来 SetMenuBar 操 作 frame 和 绕 定 的 菜单 条 .一 个 frame 窗 口 只 可 以 有 一 个 菜单 
条 。 如 果 你 新 创建 了 一 个 ， 那 么 就 的 那个 将 被 删除 和 释放 。 


GetTitle 和 SetTitle 函 数 用 来 访问 窗口 标题 栏 上 的 文本 . 


Iconize 画 数 使 得 frame 窗 口 最 小 化 或 者 从 最 小 化 状态 恢复 .你 可 以 使 用 lslconized 辑 数 检查 当前 
的 最 小 化 状态 . 


Maximize 函 数 使 得 frame 窗 口 最 大 化 或 者 从 最 大 化 状态 恢复 . 你 可 以 用 lIsMaximized 函 数 来 检查 
当前 的 最 大 化 状态 . 


Setlcon 男 数 可 以 设置 在 frame 窗 口 最 小 化 的 时 候 显 示 的 图 标 。 各 个 平台 的 窗口 管理 器 也 可 能 
把 这 个 图 标 用 于 别 的 用 途 ， 比 如 显示 在 任务 条 上 或 者 在 显示 在 窗口 浏览 器 中 。 你 还 可 以 通过 
Setlcons 辑 数 指定 一 组 不 同 产 色 和 深度 的 图 标 列表 . 


SetShape 男 数 用 来 给 frame 窗 口 设置 特定 的 显示 区 域 。 目 前 支持 这 个 加 数 的 平台 有 Windows,， 
Mac OS X, 和 GTK+ 以 及 打开 某 种 X11 扩展 功能 的 X11 版 本 . 


ShowFullScreen 函 数 使 用 窗口 在 全 屏 和 正常 状态 下 切换 ， 所 谓 全 屏 状 态 指 的 是 frame 窗 口 将 隐 
藏 尽 可 能 多 的 修饰 元 素 ， 而 尽 可 能 把 客户 区 以 最 大 化 的 方式 显示 。 可 以 使 用 lsFullScreen 函 数 
来 检测 当前 的 全 屏 状 态 . 


不 规则 的 Frame 窗 口 


如 果 你 希望 制作 一 个 外 貌 奇 特 的 应 用 程序 ， 上 比如 一 个 时 钟 程序 或 者 一 个 媒体 播放 器 ， 你 可 以 
给 frame 窗 口 指定 一 个 不 规则 的 区 域 ， 只 有 这 个 区 域 范围 内 的 部 分 才 会 被 显示 出 来 。 

一 个 没有 任何 标题 栏 ， 状 态 栏 ， 菜 单条 的 frame 窗 口 ， 它 的 重 画 函数 显示 了 一 个 企鹅， 这 
窗口 被 设置 了 一 个 区 域 使 得 只 有 这 个 企 掀 才 会 显示 。 
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显示 一 个 有 着 奇特 外 观 的 程序 的 代码 并 不 复杂 ， 你 可 以 在 附带 光盘 的 samples/shaped 目 录 里 
找到 一 个 使 用 不 同 图 片 的 完整 的 例子 。 总 的 来 说 ， 当 窗口 被 创建 时 ， 它 加 载 了 一 幅 图 片 ， 并 
且 使 用 这 幅 图 片 的 轮廓 创建 了 一 个 区 域 。 在 GTK+ 版 本 上 ， 设 置 窗 口 区 域 的 动作 必须 在 发 送 了 
窗口 创建 事件 之 后 ， 所 以 你 需要 使 用 宏 定 义 区 别 对 待 GTK+ 的 版 本 。 下 面 的 例子 演示 了 你 需要 
怎样 对 事件 表 ， 窗 口 的 构造 函数 和 窗口 的 创建 事件 处 理 画 数 进行 修改 : 


BEGIN_EVENT_TABLE(ShapedFrame, wxFrame) 
EVT_MOTION(ShapedFrame: :OnMouseMove) 
EVT_PAINT(ShapedFrame: :OnPaint ) 

#ifdef _ WXGTK__ 

EVT_WINDOW_CREATE(ShapedFrame: :OnWindowCreate) 

#endif 

END_EVENT_TABLE( ) 

ShapedFrame: :ShapedFrame( ) 

: wxFrame((wxFrame *)NULL, wxID_ANY, wxEmptyString, 
wxDefaultPosition, wxSize(250, 300), 
| wxFRAME_SHAPED 
| wxSIMPLE_BORDER 
| wxFRAME_NO_TASKBAR 
| wxSTAY_ON_TOP 


) 


m_hasShape = false; 
m_bmp = wxBitmap(wxT("penguin.png"), wxBITMAP_TYPE_PNG); 
SetSize(wxSize(m_bmp.GetWidth(), m_bmp.GetHeight())); 

#ifndef _ WXGTK__ 
// On wxGTK we can't do this yet because the window hasn't 
// been created yet so we wait until the EVT_WINDOW_CREATE 
// event happens. On wxMSW and wxMac the window has been created 
// at this point so we go ahead and set the shape now. 
SetWindowShape(); 

#endif 

} 

// Used on GTK+ only 

void ShapedFrame: :OnWindowCreate(wxwWindowCreateEvent& WXUNUSED(evt) ) 


SetWindowShape(); 


为 了 创建 一 个 区 域 模板 ， 我 们 从 一 幅 图 片 的 创建 了 一 个 区 域 ， 其 中 的 颜色 参数 用 来 指定 需 
透明 显示 的 颜色 ， 然 后 调用 frame 窗 口 的 SetShape 画 数 设 置 这 个 区 域 模板 。 


void ShapedFrame: :SetwindowShape() 


wxRegion region(m_bmp, *wxWHITE); 
m_hasShape = SetShape(region); 


为 了 让 这 个 窗口 可 以 通过 鼠标 拖 搜 来 实现 在 窗口 上 的 移动 ， 我 们 可 以 通过 下 面 的 鼠标 移动 事 
件 义理 函数 : 


void ShapedFrame: :OnMouseMove(wxMouseEvent& evt) 


{ 
wxPoint pt = evt.GetPosition(); 
if (evt.Dragging() && evt.LeftIsDown()) 
{ 
wxPoint pos = ClientToScreen(pt); 
Move(wxPoint(pos.x - m_delta.x, pos.y - m_delta.y)); 
} 
} 


而 重 画 事件 义理 函数 就 比较 简单 了 ， 当 然 在 你 的 真实 的 应 用 程序 里 ， 你 可 以 在 其 中 放置 更 多 
的 图 形 元 素 。 


void ShapedFrame: :OnPaint(wxPaintEvent& evt) 


wxPaintDC dc(this); 
dc.DrawBitmap(m_bmp, ©, ©, true); 
} 


你 也 可 以 参考 wxWidgets 的 发 行 版 中 的 samples/shaped 目 录 中 的 例子 。 
小 型 fame 窗 口 


在 Window 平 台 和 GTK+ 平 台 上 ， 你 可 以 使 用 wxMiniFrame 来 实现 那些 必须 使 用 小 的 标题 栏 的 
窗口 ， 例 如 ， 来 实现 一 个 调 色 板 工具 。 下 图 ( 译 者 注 : 这 个 图 片 应 该 是 搞 错 了 ， 是 下 一 个 例子 
中 的 图 片 ， 不 过 作者 的 翻译 源 使 用 的 就 是 这 个 图 片 ， 没 有 办 法 了 。) 演 示 了 windows 平 台 上 的 
这 种 小 窗口 的 样子 。 而 在 Max Os X 平 台 上 ， 这 个 小 窗口 则 是 直接 使 用 的 普通 的 frame 窗 口 代 
蔡 。 其 它 方面 wxMiniFrame 和 wxFrame 都 是 一 样 的 。 


.tmp) 


wxMDIParentFrame 


这 个 窗口 类 继承 自 wxFrame, 是 wxWidgets 的 MDI (多 文档 界面 ) 体系 的 组 成 部 分 。MDI 的 意思 
是 由 一 个 父 窗口 管理 需 个 或 多 个 子 窗口 的 一 种 界面 架构 。 这 种 MDI 界 面 结构 依 平台 的 不 同 而 有 
不 同 的 外 观 ， 下 图 演示 了 两 种 主要 的 外 观 。 在 windows 平 台 上 ， 子 文档 窗口 是 排列 在 其 父 窗 口 
内 的 一 组 frame 窗 口 ， 这 些 文档 窗口 可 以 被 平 铺 ， 层 县 或 者 把 其 中 的 某 一 个 在 父 窗口 的 范围 内 
最 大 化 以 便 在 某 个 时 刻 仅 显 示 一 个 文档 窗口 。 wxWidgets 会 自动 在 主 菜 单 上 增加 一 组 菜单 用 

来 控制 文档 窗口 的 这 些 操作 。MDI 界 面 的 一 个 优点 是 使 得 整个 应 用 程序 界面 相对 来 说 显得 不 那 
么 需 乱 。 这 一 方面 是 由 于 因为 所 有 的 文档 窗口 被 限制 在 父 窗口 以 内 ， 另 外 一 个 方面 ， 父 窗口 

的 菜单 条 会 被 活动 的 文档 窗口 的 菜单 条 蔡 代 ， 这 使 得 多 个 菜单 条 的 杂乱 性 也 有 所 减轻 。 


.tmp) 


而 在 GTK+ 平 台 上 ，wxWidgets 则 通过 TAB 页 面 控件 来 模拟 多 文档 界面 。 在 某 个 时 刻 只 能 有 一 
个 窗口 被 显示 ， 但 是 用 户 可 以 通过 TAB 页 面 在 窗口 之 间 进 行 切换 。 在 Mac Os 上 ，MDI 的 父 窗 
口 和 文档 窗口 则 都 使 用 和 普通 的 Frame 窗 口 一 样 的 外 观 ， 这 符合 这 样 的 一 个 事实 就 是 在 Mac 
Os 上 ， 文 档 总 是 在 一 个 新 的 窗口 中 被 打开 。 


在 那些 MDI 的 文档 窗口 包含 在 父 窗 口 之 中 的 平台 上 ， 父 窗口 将 把 它 的 所 有 的 文档 窗口 排列 在 一 
个 子 窗 口中 ， 而 这 个 窗口 可 以 和 frame 窗 口中 的 其 它 控 件 子 窗口 和 平 共 处 。 在 上 图 中 ， 父 窗口 
将 一 个 文本 框 控件 和 那些 文档 窗口 进行 了 这 样 的 排列 。 更 详细 的 情形 请 参考 WxWidgets 发 行 版 
本 的 samples/mdi 目 录 中 的 例子 。 


除了 父 窗口 的 菜单 条 外 ， 每 一 个 文档 窗口 都 可 以 有 自己 的 菜单 条 。 当 某 个 文档 窗口 被 激活 
时 ， 它 的 菜单 条 将 显示 在 父 窗口 上 ， 而 没有 子 文档 窗口 被 激活 时 ， 父 窗口 显示 自己 的 菜单 
条 。 在 构建 子 文档 窗口 的 菜单 条 时 ， 你 应该 主要 要 包含 那些 同样 命 命 的 父 窗口 的 菜单 项 ， 下 
加 上 文档 窗口 自己 的 命令 菜单 项 。 父 窗口 和 文档 窗口 也 可 以 拥有 各 自 的 工具 条 和 状态 栏 ， 但 
是 这 两 者 并 没有 类 似 菜单 条 这 样 的 机 制 。 


wxMDIParentFrame 类 的 构造 画 数 和 wxFrame 类 的 构造 画 数 是 完全 一 样 的 . 
wxMDIParentFrame 的 窗口 类 型 
wxMDIParentFrame 类 额外 的 窗口 类 型 列举 如 下 : 


| --- | --- | | wxFRAME_NO_WINDOW_MENU | Under Windows, removes the Window menu 
that is normally added automatically. | 


wxMDIParentFrame 的 成 员 画 数 
下 面 列 出 了 wxMDIParentFrame 类 除了 wxFrame 的 函数 以 外 的 主要 成 员 男 数 。 
ActivateNext 和 ActivatePrevious 函 数 激 活 前 一 个 或 者 后 一 个 子 文档 窗口 。 


Cascade 和 Tile 层 一 或 者 平 铺 所 有 的 子 窗口 . Arrangelcons 轴 数 以 图 标的 方式 平 铺 所 有 最 小 化 
的 文档 窗口 .这 三 个 函数 都 只 适用 于 Windows 平 台 . 


GetActiveChild 获 取 当 前 活动 窗口 的 指针 (如 果 有 的 话 ). 


GetClientWindowEx me 这 个 窗口 是 自动 创建 的 ， 
但 是 你 还 是 可 以 通过 重 载 OnCreateClient 函 数 来 返回 一 个 你 自己 的 继承 自 
ne 如 果 你 这 样 作 ， T a 个 多 
文档 父 窗口 


wxMDIChildFrame 


wxMDIChildFrame 窗 口 应 该 总 被 创建 为 一 个 wxMDIParentFrame 类 型 窗口 的 子 窗口 . 正如 我 们 
前 面 已 经 提 到 的 那样 ， 依 平台 的 不 同 ， 这 种 类 型 的 窗口 既 可 以 是 在 其 父 窗口 范围 内 的 一 组 窗 
口 列表 ， 也 有 可 能 是 在 桌面 上 自由 飞翔 的 普通 的 frame 窗 口 。 


除了 父 窗口 必须 不 能 关 它 的 构造 画 数 和 普通 的 frame 的 构造 画 数 是 一 样 的 。 


#include "wx/mdi.h" 

wxMDIParentFrame* parentFrame = new wxMDIParentFrame( 
NULL, ID_MYFRAME, wxT("Hello wxWidgets")); 

wxMDIChildFrame* childFrame = new wxMDIChildFrame( 
parentFrame, ID_MYCHILD, wxT("Child 1")); 

childFrame->Show(true); 

parentFrame->Show(true); 


wxMDIChildFrame 的 窗口 类 型 


wxMDIChildFrame 和 wxFrame 的 窗口 类 型 是 一 样 的 。 尽 管 如 此 ， 不 是 所 有 的 窗口 类 型 的 值 在 
各 个 平台 上 都 是 有 效 的 。 


wxMDIChildFrame 的 成 员 画 数 


wxMDIChildFrame 的 除 其 基 类 wxFrame 以 外 的 主要 成 员 画 数列 举 如 下 : 


H 


Activate 汞 数 激活 本 窗口 ， 将 其 带 到 前 台 并 且 使 得 其 父 窗口 显示 它 的 菜单 条 。 


Maximize žu% 窗口 范围 内 最 大 化 ( 仅 适用 于 windows 平 台 ). 
Restore 画 数 使 其 从 最 大 化 的 状态 恢复 为 普通 状态 ( 仅 适用 于 windows 平 台 )。 
wxDialog 


对 话 框 是 一 种 用 来 提供 信息 或 者 选项 的 顶层 窗口 。 他 可 以 有 一 个 可 选 的 标题 栏 ， 标 题 栏 上 可 
以 有 可 选 的 关闭 或 者 最 小 化 按钮 ， 和 frame 窗 口 一 样 ， 你 也 可 以 给 它 指定 一 个 图 标 以 便 显示 在 
任务 栏 或 者 其 它 的 地 方 。 一 个 对 话 框 可 以 组 合 任何 多 个 非 顶 层 窗口 或 者 控件 ， 举 例 来 说 ， 可 
以 包含 一 个 wxNoteBook 控 件 和 位 于 底部 的 两 个 确定 和 取消 按钮 。 正 如 它 的 名 字 所 指示 的 那 
样 ， 对 话 框 的 目的 相 比较 于 整个 应 用 程序 的 主 窗 口 ， 只 是 为 了 给 用 户 提示 一 些 信息 ， 提 供 一 
些 选 项 等 。 


有 两 种 类 型 的 对 话 框 : 模式 的 或 者 非 模式 的 。 一 个 模式 的 对 话 框 在 应 用 程序 关闭 自己 之 前 阻 
止 其 它 的 窗口 处 理 来 自 应 用 程序 的 消息 。 而 一 个 非 模式 的 对 话 框 的 行为 则 更 像 一 个 ffame 窗 

口 。 它 不 会 阻止 应 用 程序 中 的 别 的 窗口 继续 义理 消息 和 事件 。 要 使 用 模式 对 话 框 ， 你 应 该 调 
用 ShowModal 函 数 来 显示 对 话 框 ， 否 则 就 应 该 象 fame 窗 口 那 样 ， 使 用 Show 本 数 来 显示 对 话 
框 。 


模式 对 话 框 是 wxWindow 派 生 类 中 极 少数 允许 在 堆栈 上 创建 的 对 象 之 一 ， 换 名 话说， 你 既 可 以 
使 用 下 面 的 方法 使 用 模式 对 话 框 : 


void AskUser() 


MyAskDialog *dlg = new MyAskDialog(...); 
if ( dlg->ShowModal() == wxID_OK ) 


dlg->Destroy(); 


也 可 以 直接 使 用 下 面 的 方法 : 


void AskUser() 


MyAskDialog dlg(...); 
if ( dlg. ShowModal ( ) == wxID_OK ) 


// 这 里 不 需要 调用 Destroy( ) 函数 
} 


通常 你 应 该 从 wxDialog 类 派生 一 个 你 自己 的 类 ， 以 便 你 可 以 更 方便 的 处 理 类 似 
wxXEVT_CLOSE 这 样 的 事件 以 及 其 它 命 合 类 型 的 事件 。 通 常 你 应 该 在 派生 类 的 构造 函数 中 创 
建 你 的 对 话 框 需要 的 其 它 控 件 。 


和 wxFrame 类 一 样 ， 如 果 你 的 对 话 框 只 有 一 个 子 窗口 ， 那 么 wxWidgets 会 自动 为 你 布局 这 个 
口 ， 但 是 如 果 有 超过 一 个 子 窗口 ， 应 用 程序 应 该 自己 负责 窗口 的 布局 (参考 第 7 章 ) 


当 你 调用 Show 函 数 时 ，wxWidgets 会 调用 InitDialog 函 数 来 发 送 一 个 wxlnitDialog 事 件 到 这 个 窗 
口 ， 以 便 开始 对 话 框 数据 传输 和 验证 以 及 其 它 的 事情 。 


除了 默认 的 构造 画 数 ，wxDialog 还 拥有 下 面 的 构造 图 数 : 


wxDialog(wxWindow* parent, wxWindowID id, const wxString& title, 
const wxPoint& pos = wxDefaultPosition, 
const wxSize& size = wxDefaultSize, 
long style = wxDEFAULT_DIALOG_STYLE, 
const wxString& name = wxT("dialog")); 


例如 : 


wxDialog* dialog = new wxDialog(NULL, ID_MYDIALOG, 
wxT( "Hello wxWidgets"), wxDefaultPosition, 
wxSize(500, 300)); 

dialog->Show(true); 


#3 FA Show(true) EX Æ ShowModaliižt< AI, SiSHERETA LA, MEE EAA 
见 的 方式 进行 窗口 布局 。 


默认 情况 下 ， 如 果 对 话 框 的 父 窗口 为 NULL, 应 用 程序 会 自动 指定 其 主 窗口 为 其 父 窗口 ， 你 可 以 
通过 指定 wxDIALOG_NO_PARENT 类 型 来 创建 一 个 无 父 无 母 的 孤儿 dialog 类 ， 不 过 对 于 模式 
对 话 框 来 说 ， 最 好 不 要 这 样 作 。 


和 wxFrame 类 一 样 ， 最 好 不 要 直接 使 用 delete 操 作 符 删除 一 个 对 话 框 ， 取 而 代 之 使 用 Destroy 
或 者 Close。 以 便 在 对 话 框 的 所 有 事件 处 理 完 毕 以 后 才 释 放 对 话 框 ， 当 你 调用 Cloes 画 数 时 ， 
默认 发 送 的 wxEVT_CLOSE 事 件 的 义理 函数 其 实 也 是 调用 了 Destroy 画 数 . 


需要 注意 ， 当 一 个 模式 的 对 话 框 被 释放 的 时 候 ， 它 的 某 个 事件 处 理 范 数 需 要 调用 EndModal 范 
数 ， 这 个 画 数 的 参数 是 导致 这 次 释放 的 那个 事件 所 属 窗口 的 窗口 标识 符 ( 例 如 wxID_OK 或 者 
WxID_CANCEL). 这 样 才 能 使 得 点 用 程序 退出 这 个 模式 对 话 框 的 事件 处 理 循环 ， 从 而 使 得 调用 
ShowModal 的 代码 能 够 释放 这 个 窗口 。 而 这 个 标识 符 则 作为 ShowModal 辑 数 的 返回 值 。 我 们 
举 下 面 一 个 OnCancel 辑 数 为 例 : 


//wxID_CANCEL 的 命 命 事 件 处 理 函 数 
void MyDialog: :OnCancel(wxCommandEvent& event) 


EndModal(wxID_CANCEL) ; 


} 
// 显 示 一 个 模式 对 话 框 
void ShowDialog() 
{ 
// 创 建 这 个 对 话 框 
MyDialog dialog; 
// OnCancel HAUS ShowModal íT Ét Ht. 
if (dialog.ShowModal() == wxID_CANCEL) 
{ 


} 


下 图 展示 了 几 个 典型 的 对 话 框 ， 我 们 会 在 第 9 章 阐 述 它 们 的 创建 过 程 。 当 然 ， 对 话 框 可 以 远 比 
图 中 的 那些 更 复 亲 ， 例 如 下 面 第 二 个 图 中 的 那 祥 ， 它 包含 一 个 分 割 窗口 ， 一 个 树 形 控件 以 便 
显示 不 同 的 面板 (panels)， 以 及 一 个 扮演 属性 编辑 器 的 网 格 控件 


.tmp) 
.tmp) 
wxDialog 的 窗口 类 型 
除了 基本 窗口 类 型 以 外 ，wxDialog 还 有 下 面 一 些 窗口 类 型 可 以 使 用 : 


其 值 等 于 wxSYSTEM_MENU | wxCAPTION | 


wxDEFAULT_DIALOG_STYLE ”wxCLOSE Box. 


wxCAPTION 在 对 话 框 上 显示 标题 . 
wxMINIMIZE_BOX 在 标题 栏 显 示 最 小 化 按钮 . 
wxMAXIMIZE_BOX 在 标题 栏 显 示 最 大 化 按钮 . 
wxCLOSE_BOX 在 标题 栏 显 示 关 闭 按钮 . 
wxSTAY_ON_TOP 对 呼 框 总 在 最 前 . 仅 支持 windows 平 台 . 
wxSYSTEM_MENU 显示 系统 菜单 . 

wxRESIZE_BORDER 显示 可 变 大 小 边框 . 


如 果 创 建 对 话 框 的 时 候 父 窗口 为 NULL， 则 应 用 程序 
会 使 用 其 主 窗口 作为 对 话 框 的 父 窗 口 ， 使 用 这 个 类 型 

wxDIALOG_NO_ PARENT 可 以 使 得 在 这 种 情况 下 ， 对 话 框 强制 使 用 NULL 作 为 
其 父 窗口 。 模 式 窗口 不 推荐 强制 使 用 NULL 作 为 父 窗 
a 


下 表 解 释 了 对 话 框 类 额外 的 扩展 窗口 类 型 。 虽 然 wxWS_EX_BLOCK_EVENTS 类 型 是 窗口 基 
类 的 窗口 类 型 ， 但 是 由 于 它 是 对 话 框 类 的 默认 扩展 类 型 ， 我 们 在 这 里 也 进行 了 描述 。 


在 Windows 平 台 上 ,这 个 扩展 类 型 使 得 对 话 框 增加 
一 个 查询 按钮 .如 果 这 个 按钮 被 按 下 ， 对 话 框 将 进入 
一 种 帮助 模式 ， 在 这 种 模式 下 ， 无 论 用 户 点 击 哪 个 
子 窗口 ， 都 将 发 送 一 个 wxEVT_HELP 事 件 . 这 个 扩 
展 类 型 不 可 以 和 wxMAXIMIZE_BOX 和 
wxMINIMIZE_BOX 类 型 混用 . 


这 是 一 个 默认 被 设置 的 扩展 类 型 。 意 思 是 阻止 命令 
wxWS_EX_BLOCK_EVENTS 类 型 事件 向 更 上 一 级 的 窗口 传播 .要 注意 调用 
SetExtraStyle 函 数 可 以 重 置 这 个 扩展 类 型 . 


在 Mac OS X 平 台 上 ,这 个 扩展 类 型 导致 对 话 框 使 用 
wxDIALOG EX METAL 金属 外 观 .不 要 滥用 这 个 类 型 ， 因 为 它 默 认 用 户 的 机 
器 有 各 种 多 媒体 硬件 


wxDIALOG_EX_CONTEXTHELP 


wxDialog 事 件 


下 表 解 释 了 相对 于 窗口 基 类 来 说 额外 的 对 话 框 事件 : 


EVT_ACTIVATE(func) 


EVT_CLOSE(func) 


EVT_ICONIZE(func) 


EVT_MAXIMIZE(func) 


EVT_INIT_DIALOG(func) 


用 于 处 理 wxEVT_ACTIVATE 事 件 ,在 对 话 框 即将 激活 或 者 去 
激活 的 时 候 产 生 。 处 理 画 数 的 参数 类 型 是 
wxActivateEvent. 


用 户 义理 wxEVT_CLOSE 事 件 ,在 应 用 程序 或 者 操作 系统 即 
将 关闭 窗口 的 时 候 产生 .义理 函数 的 参数 类 型 是 
wxCloseEvent， 这 个 事件 可 以 调用 Veto 函 数 来 放弃 事件 的 
后 续 处 理 . 


用 来 处 理 wxEVT_ICONIZE 事 件 , 在 窗口 被 最 小 化 或 者 从 最 
小 化 状态 恢复 的 时 候 产 生 .处 理 画 数 的 参数 类 型 是 
wxlconizeEvent. 调用 lslconized 来 检测 到 底 是 最 小 化 还 是 从 
最 小 化 恢复 . 


用 来 处 理 wxEVT_MAXIMIZE 事 件 ,这 个 事件 在 窗口 被 最 大 化 
或 者 从 最 大 化 状态 恢复 的 时 候 产 生 ， 人 处 理 画 数 的 参数 类 型 是 
wxMaximizeEvent. 调 用 lIsMaximized 函 数 确 定 具 体 的 状态 类 
型 . 


用 于 处 理 wxEVT_INIT_DIALOG 事 件 ,在 对 话 框 初始 化 自己 
之 前 被 产生 。 久 理 函 数 的 参数 类 型 是 
wxlnitDialogEvent.wxPanel 也 会 产生 这 个 事件 .默认 执行 的 
操作 是 调用 TransferDataToWindow. 


4.5 容器 窗口 


容器 窗口 是 用 来 装载 别 的 可 见 元 素 的 窗口 ， 所 谓 可 见 元 素 指 的 是 子 窗口 或 者 是 画 在 这 个 窗口 
上 的 图 案 。 


wxPanel 


wxPanel 是 一 个 在 某 些 方面 有 点 象 dialog 窗 口 的 窗口 。 这 个 窗口 通 on LS A SF se 
框 或 者 frame 窗 口 以 外 的 其 它 控 件 窗口 。 它 也 常 被 用 来 作为 wxNoteBook 控 件 的 页 面 。 它 
使 用 系统 默认 的 颜色 。 


和 对 话 框 一 样 ， 可 以 使 用 cence aca 生 一 个 wxlnitDialogEvent 事 件 。 如 果 设 置 了 
wxTAB_TRAVERSAL 类 型 ， 那 么 它 通常 可 以 通过 使 用 类 似 TAB 键 的 导航 键 表 历 所 有 它 上 面 的 
子 控件 。 


除了 默认 的 构造 男 数 以 外 ，wxPanel 还 拥有 下 面 的 构造 画 数 : 


wxPanel(wxWindow* parent, wxWindowID id, 
const wxPoint& pos = wxDefaultPosition, 
const wxSize& size = wxDefaultSize, 
long style = wxTAB_TRAVERSAL |wxNO_BORDER, 
const wxString& name = wxT("panel")); 


用 法 如 下 : 


wxPanel* panel = new wxPanel(frame, wxID_ANY, 
wxDefaultPosition, (500, 300)); 


wxPanel 的 窗口 类 型 
wxPanel 没 有 额外 的 窗口 类 型 。 
wxPanel BAX i EK 
wxPanelt3 324 ai roy A EB. 
wxNotebook 


这 个 类 提供 了 一 个 有 多 个 页 面 的 窗口 ， 页 面 之 间 可 以 通过 边 上 的 TAB 按钮 来 切换 。 每 个 页 面 通 
常 是 一 个 普通 的 wxPanel 窗 口 或 者 其 派生 类 ， 当 然 你 完全 可 以 使 用 别 的 窗口 。 


NoteBook 的 TAB 按钮 可 以 包含 一 个 图 片 ， 也 可 以 包含 一 个 文本 标签 。 图 片 是 由 
wxlmageList (参考 第 10 章 ) 提供 的 ， 是 通过 在 列表 中 的 位 置 和 页 面 对 应 的 。 


使 用 notebook 的 方法 是 ， 创 建 一 个 wxNotebook 对 象 ， 然 后 调用 其 AddPage 方 法 或 者 
InserPage 方 法 ， 传 递 一 个 用 来 作为 页 面 的 窗口 指针 。 不 要 手动 释放 那些 已 经 被 wxNoteBook 
作为 页 面 的 窗口 ， 你 点 该 使 用 DeletePage 来 而 除 某 个 页 面 或 者 干脆 等 到 notebook 笠 放 它 自己 
的 时 候 。notebook 会 一 并 释放 那些 页 面 . 


下 面 举例 说 明 怎 样 创建 一 个 有 三 个 页 面 ， 包 含 文本 和 图 片 的 TAB 标签 的 notebook : 


#include "wx/notebook.h" 

#include "copy. xpm" 

#include "cut.xpm" 

#include "paste.xpm" 

// 创 建 notebook 

wxNotebook* notebook = new wxNotebook(parent, wxID_ANY, 
wxDefaultPosition, wxSize(300, 200)); 

// 创建 图 片 列表 

wxImageList* imageList = new wxImageList(16, 16, true, 3); 

imageList->Add(wxIcon(copy_xpm)); 

imageList->Add(wxIcon(paste_xpm)); 

imageList->Add(wxIcon(cut_xpm)); 

// 创建 页 面 

wxPaneli* window1 = new wxPanel(notebook, wxID_ANY); 

wxPanel2* window2 = new wxPanel(notebook, wxID_ANY); 

wxPanel3* window3 = new wxPanel(notebook, wxID_ANY); 

notebook->AddPage(window1, wxT("Tab one"), true, 0); 

notebook->AddPage(window2, wxT("Tab two"), false, 1); 

notebook->AddPage(window3, wxT("Tab three"), false 2); 


下 图 演示 了 上 述 代码 在 windows 平 台 上 的 结 





; & Tab Two T Tab Three 


在 大 多 数 的 平台 上 ， 当 TAB 页 面 数量 太 多 不 能 被 完全 显示 的 时 候 ， 都 会 自动 出 现 导 航 按钮 。 但 
是 在 Mac OS 上 ， 这 个 导航 按钮 是 不 会 出 现 的 ， 因 此 在 这 个 系统 上 ， 可 以 使 用 的 页 面 数 目 将 受 
到 窗口 大 小 和 TAB 标 签 大 小 的 限制 。 


如 果 你 在 每 个 页 面 上 都 使 用 布局 控件 ， 并 且 在 创建 notebook 的 时 候 使 用 默认 的 大 小 
wxDefaultSize, 那 么 wxNotebook 将 会 自动 调整 大 小 以 适合 它 的 页 面 。 


Notebook 窗 口 主 题 管理 


{Windows Xp 系统 中 ， 默 认 的 窗口 主题 会 给 notebook 的 页 面 添加 过 渡 色 。 虽 然 这 是 预期 的 本 
地 行为 ， 但 是 它 可 能 会 降低 性 能 。 出 于 审美 方面 的 原因 ， 你 可 能 想 直 接 使 用 单一 的 色彩 ， 尤 
其 是 当 notebook 不 是 位 于 一 个 对 话 框 以 内 的 时 候 。 如 果 你 想 阻 止 这 种 默认 的 行为 ， 可 以 采用 
以 下 三 种 办 法 : 第 一 : 你 可 以 给 你 的 notebook 指 定 wxNB_NOPAGETHEM 类 型 来 禁止 某 个 特 
定 的 notebook 的 这 种 效果 ， 或 者 你 可 以 使 用 wxSystemOptions::SetOption 来 在 应 用 程序 范围 
内 禁止 它 ， 或 者 你 可 以 使 用 SetBackgroundColour 函 数 来 给 某 个 单独 的 页 面 禁 止 它 。 要 在 应 用 


程序 范围 内 禁止 它 ， 你 可 以 使 用 下 面 的 代码 : 
wxSystemOptions::SetOption(wxT("msw.notebook.themed-background"), 0); 将 它 的 值 设置 
成 1 可 以 再 次 允许 这 种 效果 。 要 让 某 个 单独 的 页 面 禁 用 这 种 效果 可 以 使 用 下 面 的 方法 : 


wxColour col = notebook->GetThemeBackgroundColour(); 
if (col.0k()) 
{ 


page->SetBackgroundColour (col); 


在 windows 系 统 以 外 的 平台 ， 或 者 如 果 一 个 应 用 程序 没有 使 用 主题 风格 ， 
GetThemeBackgroundColour 都 将 返回 一 个 未 初始 化 的 颜色 ， 因 此 上 面 的 代码 在 各 个 平台 都 
是 可 以 使 用 的 。 另 外 就 是 上 述 的 这 部 分 代码 的 语法 和 行为 是 有 可 能 在 将 来 的 wxWidgets 版 本 中 
发 生变 化 ， 请 参考 你 本 地 wxWidgets 发 行 版 中 的 wxNotebook 类 的 文档 来 获取 最 新 的 信息 。 


wxNotebook 的 窗口 类 型 


wxNotebook 可 以 拥有 下 面 的 额外 窗口 类 型 : 


wxNB_TOP 标签 放 在 顶部 . 
一 kk was 人 . 人 + 日 s+ NN: 
wxNB_LEFT T R: 不 是 所 有 的 WindowsXp 的 主题 都 支持 这 个 选 
人 入， 
wxNB_RIGHT 标签 在 右面 . 不 是 所 有 的 WindowsXp 的 主题 都 支持 这 个 选项 . 
wxNB_BOTTOM 标签 在 底部 . 不 是 所 有 的 WindowsXp 的 主题 都 支持 这 个 选项 . 
wxNB_FIXEDWIDTH 所 有 标签 宽度 相同 . 仅 适用 于 windows. 
wxNB_MULTILINE 可 以 有 多 行 的 标签 . 仅 适用 于 windows 


WNB NOPAGETHEME ”在 Windos 上 禁用 主题 风格 .以 提高 性 能 和 提供 另外 一 种 审美 先 
i 择 


wxNotebook 的 事件 
WXxNotebook 可 以 产生 wxNotebookEvent 事 件 ， 这 个 事件 可 以 被 它 和 它 的 继承 者 处 理 . 


EVT_NOTEBOOK_PAGE_CHANGED(id,func) ”当前 页 面 已 经 改变 . 


EVT_NOTEBOOK_PAGE_CHANGING(id,func) SEE g 你 可 以 使 用 Veto 


wxNotebook 的 成 员 画 数 


AddPage 增 加 一 个 页 面 ,InsertPage 在 某 个 固定 位 置 插入 一 个 页 面 .你 可 以 使 用 文本 标签 或 者 图 
片 标签 或 者 两 者 都 有 ， 用 法 如 下 : 
// 增 加 一 个 使 用 了 文本 和 图 片 两 种 标签 都 有 的 页 面 ， 并 且 当 前 处 于 未 选中 状态 。 


// (其 中 图 片 使 用 的 是 图 片 列表 中 的 索引 为 2 的 那个 ). 
notebook->AddPage(page, wxT("My tab"), false, 2); 


DeletePage 函 数 移 除 并 且 释 放 某 个 特定 的 页 面 ， 而 RemovePage 辑 数 则 仅仅 是 移 除 这 个 页 
面 。DeleteAllPages 函 数 用 来 删除 所 有 的 页 面 。 当 wxNoteBook 被 释放 时 ， 它 也 会 自动 删除 所 
有 的 页 面 


AdvanceSelection 画 数 循环 选择 页 面 。 SetSelection 辑 数 以 基于 0 的 索引 选择 特定 的 页 面 
GetSelection 取 得 当前 选中 页 面 的 索引 或 者 返回 wxNOT_FOUND. 


SetlmageList 函 数 用 来 给 Notebook 设 置 一 人 oe 这 个 函数 仅 是 设置 而 不 绑 定 图 片 列 
表 ， 这 意味 着 在 notebook 控件 被 删除 的 时 候 ， 这 个 图 片 列表 控件 并 不 会 被 删除 ， 如 果 你 希望 
使 用 绑 定 ， 则 可 以 使 用 AssigniImageList 函 数 . ee E a 
表 对 象 .图 片 列 表 对 象 用 来 提供 每 个 页 面 标签 中 使 用 的 图 片 ， 详 情 请 参考 第 10 章 。 


GetPage 函 数 用 来 返回 和 某 个 素 引 对 应 的 页 面 窗口 指针 , GetPageCounthW An RE Km eR. 
SetPageText 和 GetPageText 用 来 操作 页 面 标 签 上 的 文本 . 

SetPagelmage 和 GetPagelmage 用 来 操作 页 面 标签 上 的 图 片 在 图 片 列 表 中 的 索引 ， 
wxNotebook 的 替代 选择 


wxNotebook 是 wxBookCtrlBase 的 派生 类 , 这 个 基 类 是 用 来 提供 用 于 管理 一 组 页 面 的 所 有 数据 
和 方法 的 抽象 类 。 和 wxNotebook 有 着 相似 API 的 类 还 有 两 个 ， 一 个 是 wxListbook， 一 个 是 
wxChoicebook, 你 也 可 以 实现 你 自己 的 类 ， 上 比如 你 可 以 实现 一 个 wxTreebook. 


wxListbook 使 用 一 个 wxListCtrl 变 量 来 控制 页 面 ;ListCtrl 控 件 是 一 种 在 内 部 显示 一 组 带 有 标签 的 
图 片 的 控件 . 在 wxListbook 中 ， 相 关 的 ListCtrl 控 件 可 以 显示 在 上 下 左右 四 个 方向 ， 默 认 是 在 左 
边 。 这 是 wxNotebook 的 一 个 很 有 吸引 力 的 替代 者 。 因 为 即使 在 Mac Os X 平 台 上 ，ListCtrl 可 
以 管理 的 项 目 数 量 也 几乎 没有 限制 ， 因 此 wxListbook 可 以 管理 的 页 面 数 也 不 受 窗口 大 小 和 标 
签 长 度 的 限制 。 


WxChoicebook 则 使 用 一 个 选择 控件 (一 个 下 拉 列 表 ) 来 管理 页 面 。 上 比较 适用 于 窗口 空间 比较 
小 的 场合 。 这 个 控件 不 会 在 页 面 标签 处 显示 图 片 ， 而 且 默 认 情 况 下 ， 选 择 控件 显示 在 整个 控 
件 的 上 方 。 


上 述 这 两 个 控件 的 头 文 件 分 别 为 wx/listbook.h 和 wx/choicebk.h. 它 们 的 事件 处 理 画 数 的 参数 类 
型 分 别 为 wxListbookEvent 和 wxChoicebookEvent 类 型 ， 事 件 影射 宏 则 分 别 为 
EVT_XXX_PAGE_CHANGED(id, func) 和 EVT_XXX_PAGE_CHANGING(id,func), 其 中 XXX 代 
表 LISTBOOK 或 者 CHOICEBOOK. 


你 可 以 使 用 类 似 wxNotebook 定 义 的 那些 窗口 类 型 ， 也 可 以 类 似 用 wxCHB_TOP 或 者 
wxLB_TOP 取 代 wxNB_TOP 这 样 的 窗口 类 型 ， 它 们 的 值 都 是 一 样 的 ， 


wxScrolledWindow 


尽管 所 有 的 窗口 都 可 以 拥有 滚动 条 ， 但 是 为 了 让 滚动 条 工作 ， 还 需要 一 些 额外 的 代码 。 这 个 
类 则 为 让 不 同类 型 的 窗口 类 中 的 滚动 条 正确 工作 提供 了 足够 的 灵活 性 。 wxScrolledWindow 主 
要 实现 了 那些 让 窗口 可 以 以 一 定 的 单位 连续 的 滚动 〈 而 不 是 不 定 大 小 的 跳跃 ) ， 也 可 以 定义 
在 使 用 翻 页 键 进行 翻 页 的 时 候 的 大 小 。 这 种 实现 通常 仅 适用 于 类 似 画 图 程序 中 的 那 种 翻 页 功 
能 ， 对 于 一 些 复 条 功能 的 文本 编辑 程序 则 不 一 定 适 合 。 因 为 富 文本 编辑 器 中 每 一 
宽度 都 有 可 能 不 同 。wxGrid 网 格 控件 就 是 这 样 的 一 个 例子 〈 在 网 格 控件 中 ， 每 一 行 和 每 一 列 
的 宽度 都 有 可 能 不 同 ) ， 在 这 种 情况 下 ， 你 应 该 自己 直接 从 wxWindow 类 ees 
从 而 实现 自己 的 窗口 滚动 机 制 。 


要 适用 滚动 窗口 ， 你 需要 提供 每 次 逻辑 移动 的 单位 (也 就 是 当 人 处理 上 滚 一 行 和 下 滚 一 行 时 窗 
口 应 该 移动 的 大 小 ) 以 及 整个 窗口 的 虚拟 逻辑 大 小 。 然 后 wxScrollWindow 类 就 会 自己 关注 是 
否 显 示 滚 动 条 ， 以 及 滚动 条 上 的 滑 钮 应 该 用 多 大 显示 等 等 这 些 细 节 问 题 . 


下 面 演 示 了 怎样 创建 一 个 滚动 窗口 : 


#include "wx/scrolwin.h" 

wxScrolledwWindow* scrolledwindow = new wxScrolledwindow( 
this, wxID_ANY, wxPoint(0, ©), wxSize(400, 400), 
wxVSCROLL | wxHSCROLL ) ; 

// 设置 窗口 的 虚拟 逻辑 大 小 : 1000x1000 

// 每 次 滚动 10 个 象 素 

int pixelsPerUnixx 

int pixelsPerUnixY 

int noUnitsX = 1000; 

int noUnitsY = 1000; 

scrolledWindow->SetScrollbars(pixelsPerUnitX, pixelsPerUnityY, 
noUnitsX, noUnitsyY); 


10; 
10; 


第 二 种 设置 虚拟 大 小 的 方法 是 使 用 SetVirtualSize 函 数 ， 它 的 参数 是 以 象 素 为 单位 的 虚拟 大 

小 。 然 后 再 用 SetScrollRate 画 数 来 设置 水 平和 垂直 方向 上 的 滚动 增 量 。 第 三 种 方法 是 使 用 布 
局 控件 来 布局 窗口 ， 滚 动 窗口 会 自动 计算 所 有 子 窗口 需要 的 窗口 大 小 作为 窗口 的 虚 大 小 ， 你 
同样 需要 调用 SetScrollRate 画 数 来 设置 滚动 增 量 。 


你 可 以 想 普 通 窗口 那样 使 用 重 画 事件 ， 但 是 在 进行 任何 窗口 重 画 动作 之 前 你 应 该 调用 
DoPrepareDC 函 数 来 保证 重 画 动作 以 当前 的 窗口 原点 作为 原点 ， 就 象 下 面 演示 的 那样 : 


void MyScrolledWindow: :OnPaint(wxPaintEvent& event) 


wxPaintDC dc(this); 
DoPrepareDC(dc); 

dc.SetPen( *wxBLACK_PEN); 
dc.DrawLine(0, ©, 100, 100); 


(Rt8 By Ll eS BR OnDrawk Nat, wxScrolledWindow7ti8§ Aix SWAUZA, ABA 
DoPrepareDCWR, AHRR RAR FARRAH : 


void MyScrolledwindow: :OnDraw(wxDC& dc) 


{ 
dc.SetPen( *wxBLACK_PEN); 


dc.DrawLine(0, ©, 100, 100); 
} 


metab, Ese St xe PRS See, (lal + a 2218 ADoPrepareDC 
ER, 


你 也 可 以 象 下 面 这 样 提 供 你 自己 的 DoPrepareDC 画 数 ， 这 个 函数 默认 的 行为 只 是 把 设 各 操作 
原点 移动 到 当前 滚动 条 开始 的 位 置 : 


void wxScrolledWindow: :DoPrepareDC(wxDC& dc) 


{ 
int ppuX, ppuY, startX, starty; 
GetScrollPixelsPerUnit(& ppuX, & ppuY); 
GetViewStart(& startX, & startyY); 
dc.SetDeviceOrigin( - startX * ppuX, - startY * ppuY ); 
} 


关于 在 wxScrollWindow 上 进行 作 图 的 详细 情形 ， 包 括 怎样 使 用 双 缓 冲 区 ， 请 参考 第 5 章 ,，ii 光 
重 画 和 打印 i 人 % 中 的 wxPaintDC 小 节 。 


wxScrolledWindow 的 窗口 类 型 


wxScrolledWindow 类 并 没有 特别 的 窗口 类 型 ， 但 是 通常 需要 设置 wxVSCROLL|wxHSCROLL 
类 型 ， 这 也 是 wxScrolledWindow 的 默认 类 型 。 在 某 些 平台 上 因为 效率 的 原因 可 能 不 支持 这 两 
个 类 型 。 


wxScrolledWindow 的 事件 


WxScrolledWindow 会 产生 wxScrollWinEvent 事 件 (参见 下 表 ) .这 些 事件 不 会 在 父子 窗口 关系 
中 传播 ， 因 此 要 处 理 这 种 事件 ， 你 必须 定义 自己 的 滚动 窗口 派生 类 或 者 挂 载 你 自己 的 事件 
表 。 不 过 在 通常 情况 下 ， 你 并 不 需要 覆盖 默认 的 处 理 画 数 来 自己 处 理 这 些 事件 。 


EVT_SCROLLWIN(func) 处 理 所 有 滚动 事件 . 


EVT_SCROLLWIN_TOP(func) 义理 事件 wxEVT_SCROLLWIN_TOP， 滚 动 


到 最 顶端 . 

处 理事 件 WxEVT_SCROLLWIN_BOTTOM s& 
EVT_SCROLLWIN_BOTTOM(func) E 
en ee 处 理事 人 wxEVT_SCROLLWIN_LINEUP 上 六 
EVT_SCROLLWIN_LINEDOWN(func) meen ety ey 
ieee HUME Celine 处 理事 什 wxEVT_SCROLLWIN_PAGEUP 上 

AX DA . 

义理 事件 
EVT_SCROLLWIN_PAGEDOWN (func) | wxEVT_SCROLLWIN_PAGEDOWN 下 滚 一 

T 


wxScrolledWindow 的 成 员 画 数 介绍 


CalcScrolledPosition 和 CalcUnscrolledPosition 函 数 都 需要 四 个 参数 ， 前 两 个 整数 参数 是 输入 
需要 计算 的 点 ， 后 两 个 则 是 指向 整数 的 指针 用 来 放置 计算 结果 。 第 一 个 画 数 用 来 计算 实际 位 
置 到 逻辑 位 置 的 映射 。 如 果 当 前 的 滚动 条 下 滚 了 10 个 象 素 ， 则 0 这 个 数字 作为 输入 将 得 到 对 应 
输出 -10, 第 二 个 汞 数 则 实现 相反 的 功能 。 


EnableScrolling 画 数 用 来 允许 或 者 禁止 垂直 或 者 水 平方 向 的 物理 滚动 。 物 理 滚动 的 含义 是 说 
在 收 到 滚动 事件 的 时 候 对 窗口 进行 物理 上 的 平移 。 但 是 如 果 应 用 程序 需要 不 等 量 的 移动 ( 比 
如 ， 由 于 字体 的 不 同 为 了 避免 滚动 的 时 候 显 示 半 行 字 的 情况 出 现 ) ， 则 需要 禁止 物理 移动 ， 
在 这 种 情况 下 ， 应 用 程序 需要 自己 移动 对 应 的 子 窗 口 。 物 理 移 动 在 折 有 支持 物理 移动 的 平台 
上 都 是 默认 打开 的 。 当 然 不 是 所 有 的 平台 都 支持 物理 移动 。 


GetScrollPixelsPerUnit 范 数 在 两 个 指向 整数 的 指针 中 返回 水 平和 垂直 方向 上 的 移动 单位 。 返 
回 0 表示 在 那个 方向 上 不 能 滚动 


GetViewStart 函 数 返回 窗口 可 视 部 分 左上 角 的 座 标 ， 单 位 是 逮 辑 单位 ， 你 需要 乘 以 
GetScrollPixelsPerUnit 的 返回 值 以 便 将 结果 转换 成 象 素 单位 。 


GetVirtualSize 返 回 当 前 设 定 的 以 象 素 为 单位 的 虚拟 窗口 大 小 。 
DoPrepareDC 将 画 画 设 各 的 原点 设置 到 当前 的 可 见 原 点 。 
Scroll 画 数 将 窗口 滚动 到 一 个 特定 的 逮 辑 单位 位 置 (注意 这 里 的 单位 不 是 象 素 ) . 


SetScrollbars 用 来 设置 移动 单位 的 象 素 值 ,各 个 方向 的 移动 单位 总 数 ,水 平 或 者 垂直 方向 的 当前 
滚动 位 置 (可 选 ) 以 及 是 否 立 即 刷新 窗口 RAD) 等 。 


SetScrollRate 用 来 设置 滚动 单位 ， 相 当 于 单独 设置 SetScrollbars 中 的 移动 单位 参数 . 


SetTargetWindow 用 来 滚动 非 wxScrolledWindow 类 型 的 其 它 窗口 . 
滚动 非 wxScrolledWindow 类 型 的 窗口 


如 果 你 想 自 己 实 现 窗口 的 滚动 行为 ， 你 可 以 直接 从 wxWindow 派 生 你 的 窗口 类 ， 然 后 使 用 
SetScrollbar 函 数 来 设置 这 个 窗口 的 滚动 条 。 


SetScrollbar 函 数 的 参数 如 下 表 的 说 明 : 


int orientation 滚动 条 的 类 型 : wxVERTICAL or wxHORIZONTAL. 
int position 滚动 条 滑 块 的 位 置 ， 逻 辑 滚动 单位 . 

int visible 可 见 部 分 大 小 ， 逻 辑 滚动 单位 . 通常 会 决定 滑 块 的 长 度 . 
int range 滚动 条 的 最 大 长 度 ， 逻 辑 滚 动 单位 . 


bool refresh 是 否 立 即 刷新 窗口 . 


举例 来 说 ， 如 果 你 想 显示 一 个 50 行 文本 的 文本 窗口 ， 使 用 同样 的 字体 ， 而 窗口 的 大 小 只 够 显 
示 16 行 ， 你 可 以 使 用 下 面 的 代码 : 


SetScrollbar(wxVERTICAL, 0, 16, 50) 


注意 在 上 面 的 例子 中 ， 滑 块 的 位 置 永远 不 可 能 大 于 50-16=34. 
你 可 以 通过 用 当前 窗口 除 以 当前 字体 下 文本 的 高 度 来 得 到 当前 窗口 可 以 显示 多 少 行 这 个 值 。 


如 果 你 是 自己 实现 滚动 行为 ， 你 总 是 需要 在 窗口 大 小 发 生 改 变 的 时 候 更 改 滚 动 条 的 设置 。 
此 你 可 以 在 首次 计算 滚动 条 参数 的 代码 中 使 用 AdjustScrollbars 画 数 ， 然 后 在 wxSizeEvent 的 
处 理事 件 中 使 用 AdjustScrollbars 函 数 。 


你 可 以 参考 WxGrid 控 件 的 代码 来 获得 实现 自 定义 滚动 窗口 的 更 多 灵感 。 


你 也 可 以 参考 wxWidgets 手 册 中 的 wxVScrolledWindow 类 ， 它 可 以 用 来 建立 一 个 可 以 在 垂直 方 
向 进行 不 固定 单位 滚动 的 窗口 类 。 


wxSplitterWindow 


这 个 类 用 来 管理 最 多 两 个 窗口 ， 如 果 你 想 在 更 多 窗口 中 实现 分 割 ， 你 可 以 使 用 多 个 分 割 窗 
口 。 当 前 的 窗口 可 以 被 应 用 程序 分 割 成 两 个 窗口 ， 上 比如 通过 一 个 菜单 命 分 ， 也 可 以 通过 应 用 
程序 命令 或 者 通过 分 割 窗口 的 用 户 操作 界面 (双击 分 割 条 或 者 拖 搜 分 割 条 使 得 其 中 一 个 窗口 
的 大 小 变 为 0) 重新 变 为 一 个 窗口 .其 中 拖 搜 分 割 条 的 方法 将 会 受到 后 面 会 提 到 的 
SetMinimumPaneSize 方 法 的 限制 。 


在 大 多 数 平台 上 ， 当 分 割 条 被 拖 搜 时 ， 会 有 一 个 和 背景 颜色 相反 的 坚 条 随 之 移动 以 显示 分 割 
条 的 最 终 位 置 ， 你 可 以 通过 使 用 wxSP_LIVE_UPDATE 窗 口 类 型 来 使 得 分 割 条 以 实时 方式 通 
过 直接 改变 两 个 窗口 的 大 小 来 代替 那 种 默认 方式 。 实 时 方式 是 Mac OS X 上 默认 的 也 是 唯一 的 
方式 。 


wxWidgets 跨 平台 GUI 编程 


下 面 的 代码 演示 了 怎样 创建 一 个 分 割 窗口 来 操作 两 个 窗口 并 且 隐 藏 其 中 的 一 个 : 


#include "wx/splitter.h" 
wxSplitterWindow* splitter = new wxSplitterWindow(this, wxID_ANY, 

wxPoint(0, 0), wxSize(400, 400), wxSP_3D); 
leftWindow = new MyWindow(splitter); 
leftwindow->SetScrollbars(20, 20, 50, 50); 
rightWindow = new MyWindow(splitter); 
rightWindow->SetScrollbars(20, 20, 50, 50); 
rightWindow->Show( false); 
splitter->Initialize(leftWindow) ; 
// 去 掉 下 面 的 注释 以 便 禁 止 窗口 隐藏 
// splitter->SetMinimumPaneSize(20); 
下 面 的 代码 代码 演示 了 创建 分 割 窗口 以 后 怎样 使 用 它 : 
void MyFrame: :OnSplitVertical(wxCommandEvent& event) 
{ 

if ( splitter->IsSplit() ) 

splitter->Unsplit(); 

leftWindow->Show( true) ; 

rightWindow->Show( true); 

splitter->SplitVertically( leftwWindow, rightWindow ); 


void MyFrame: :OnSplitHorizontal(wxCommandEvent& event) 
{ 
if ( splitter->IsSplit() ) 
splitter->Unsplit(); 
leftwindow->Show(true); 
rightWindow->Show(true); 
splitter->SplitHorizontally( leftWindow, rightWindow ); 


void MyFrame: :OnUnsplit(wxCommandEvent& event) 


{ 
if ( splitter->IsSplit() ) 
splitter->Unsplit(); 


下 图 演示 了 分 割 窗口 在 windows 平 台 上 的 例子 ， 在 这 个 例子 中 ， 分 割 窗口 没有 使 用 


wxSP_NO_XP_THEME 类 型 。 如 果 使 用 了 这 个 类 型 ， 分 割 窗 口 将 会 拥有 更 传统 的 下 沉 边 框 和 


3 维 外 观 。 
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wxSP_3D 使 用 三 维 效果 的 边框 和 分 割 条 . 


wxSP_3DSASH 使 用 三 维 效果 分 割 条 . 
wxSP_3DBORDER 和 xSP_BORDER 效 果 相同 
wxSP_BORDER 使 用 标准 边框 . 
wxSP_NOBORDER 无 边框 (默认 值 ). 


wxSP_NO_XP_THEME EJAM. 


在 Xp 操作 系统 上 ， 如 果 你 不 喜欢 默认 的 效果 ， 使 用 三 维 边 


wxSP_PERMIT_UNSPLIT ”即使 设置 了 最 小 值 也 允许 窗口 被 隐藏 . 
wxSP_LIVE_UPDATE 在 分 割 条 移动 的 时 候 实时 更 新 窗口 . 


wxSplitterWindow 事 件 


wxSplitterWindow/# FwxSplitterEvent # W Ass 44 x 2 


EVT_SPLITTER_SASH_POS_CHANGING(id,func) 


EVT_SPLITTER_SASH(id, func) 


EVT_SPLITTER_UNSPLIT(id,func) 


EVT_SPLITTER_DCLICK(id,func) | BF 


用 于 处 理 
wxEVTCOMMAND_SPLITTER_S 
POS_CHANGING 事 件 ,在 分 割 条 位 
改变 的 时 候 产 生 。 调 用 Veto 函 数 阻 
移动 ， 或 者 调用 事件 的 SetSashPo 
数 来 更 改 分 割 条 的 位 置 . 


用 于 人 处理 wxEVTCOMMAND SPLI 
SASH_POS _CHANGED 事 件 , 分 割 
置 已 经 改变 你 可 以 通过 事件 的 
SetSashPosition 2X RE 1E 3x FHL X 
改变 化 的 幅度 . 


用 于 处 理 
wxEVT_COMMAND_SPLITTER | 
事件 ,在 有 某 个 窗口 被 隐藏 的 时 候 产 


wxEVT_COMMAND_SPLITTER_DOUBLECLICKED 事 件 ,在 分 割 条 被 双击 的 时 候 产 生 . | 


wxSplitterWindow 的 成 员 函 数 


GetMinimumPaneSize#l SetMinimumPaneSizerx š FA F% 


作 分 割 窗口 的 最 小 窗 格 大 小 。 默 认 


为 0, 意 味 着 分 割 窗口 的 每 一 侧 的 大 小 都 可 以 被 缩减 至 0。 相 当 于 移 除 某 一 部 分 分 割 窗口 .要 阻止 
这 种 情形 ， 也 为 了 阻止 拖 搜 分 割 条 的 时 候 超出 边界 ， 可 以 将 其 设置 成 一 个 大 于 0 的 值 比如 20 个 
象 素 。 虽 然 这 样 ， 如 果 设 置 了 wxSP_PERMIT_UNSPLIT 窗 口 类 型 ， 即 使 最 小 值 设置 为 大 于 0 


的 数 ， 也 还 是 可 以 将 某 个 分 割 窗口 隐藏 。 


GetSashPosition 和 SetSashPosition 用 来 操作 分 割 条 的 位 置 
轴 数 导致 分 割 条 被 立刻 刷新 。 


， 传递 true 参 数 给 SetSashPosition 


GetSplitMode 和 SetSplitMode 函 数 用 来 设置 分 割 的 方向 wxSPLIT_VERTICAL 或 者 
wxSPLIT_HORIZONTAL. 


GetWindow1 和 GetWindow2 用 来 获取 两 个 分 割 窗 口 的 指针 。 
Initialize 函 】 数 使 用 一 个 窗口 指针 参数 调用 ， 用 来 显示 两 个 分 割 窗口 中 的 某 一 个 窗口 。 
IsSplit 函 数 用 来 判断 窗口 是 否 处 于 分 割 状态 . 


ReplaceWindow 用 来 替换 被 分 割 窗口 控制 的 两 个 窗口 中 的 一 个 。 使 用 这 个 函数 要 好 过 先 使 用 
Unsplit 函 数 然后 再 增加 另外 一 个 窗口 . 


SetSashGravity 用 一 个 浮 点 小 数 来 设置 分 割 比例 。0.0 表 示 只 显示 右边 或 者 下 边 的 窗口 ，1.0 表 
示 只 显示 左边 或 者 上 边 的 窗口 。 中 间 的 值 则 表示 按照 某 种 比例 分 配 两 个 窗口 的 大 小 。 使 用 
GetSashGravity 函 数 来 获取 当前 的 分 割 比例 。 


SplitHorizontally 落 数 SplitVertically 使 用 一 个 可 选 的 分 割 尺寸 来 初始 化 分 割 窗口 。 
Unsplit 去 掉 指 定 的 那个 分 割 窗口 . 

UpdateSize 用 来 使 得 分 割 窗 口 立即 刷新 (通常 情况 下 ， 这 是 在 系统 空闲 的 时 候 完 成 的 ). 
布局 控件 中 使 用 wxSplitterWindow 的 说 明 


在 布局 控件 中 使 用 分 割 窗 口 有 一 点 细微 之 处 需要 说 明 一 下 。 如 果 你 不 需要 这 个 分 割 窗口 的 分 
割 条 是 可 移动 的 ， 你 可 以 在 创建 两 个 子 窗口 的 时 候 指定 绝对 大 小 。 这 将 固定 这 两 个 子 窗口 的 
最 小 大 小 ， 从 而 使 得 分 割 条 不 能 自由 移动 。 如 果 你 希望 分 割 条 能 正常 移动 ， 在 创建 两 个 子 窗 
口 的 时 候 你 就 需要 使 用 默认 的 大 小 ， 然 后 在 分 割 窗 口 的 攀 造 画 数 中 指定 其 最 小 大 小 。 然 后 在 
将 这 个 分 割 窗 口 增加 到 布局 控件 的 时 人 息 ， 在 Add 男 数 中 使 用 wxFIXED_MINSIZE 标 记 来 告诉 
wxWidgets 将 分 割 窗口 控件 当前 的 大 小 作为 其 最 小 大 小 。 


另外 一 种 情况 是 ， 分 割 窗 口 没 有 设 定 分 割 条 的 位 置 ， 也 没有 设 定 它 的 子 窗口 的 大 小 ， 当 布局 
控件 完成 布局 时 ， 分 割 窗口 不 愿意 过 早 的 设置 分 割 条 的 位 置 ， 而 要 等 到 系统 空闲 的 时 候 (这 
是 它 的 默认 行为 ) 。 在 这 种 情况 下 ， 我 们 可 能 会 看 到 当 窗 口 刚刚 可 见 的 时 候 分 割 条 复位 自己 
的 位 置 。 为 了 避免 出 现 这 种 情景 ， 我 们 应 该 在 对 布局 控件 调用 Fit 之 后 ， 马 上 调用 分 割 窗口 的 
UpdateSizer it H/F IZ Bl BAT. 


默认 情况 下 ， 当 用 户 或 者 应 用 程序 改变 分 割 窗口 的 大 小 时 ， 只 有 底 端 (或 者 右 端 ) 的 子 窗口 
改变 自己 的 大 小 以 便 获 取 或 减 小 额外 的 空间 ， 要 改变 这 种 默认 的 行为 ， 你 可 以 使 用 前 面 说 过 
的 SetSashGravity 玉 数 指定 一 个 固定 的 分 割 比例 。 

wxSplitterWindow 的 替代 者 

如 果 在 应 用 程序 中 你 需要 使 用 很 多 的 分 割 窗 口 ， 不 妨 考 虑 使 用 wxSashWindow. 这 个 窗口 允许 


它 的 任何 按 成 为 一 个 分 割 条 ， 以 便 和 将 其 分 割 成 多 个 窗口 。 而 新 分 的 这 些 窗口 通常 是 用 户 创建 
的 wxSashWindow 的 子 窗口 。 


wxWidgets 跨 平台 GUI 编程 


当 wxSashWindow 的 分 割 条 被 拖 动 时 ， 会 向 应 用 程序 发 送 wxSashEvent 事 件 以 便 事件 处 理 函 
数 可 以 相应 的 进行 窗口 布局 。 布 局 是 通过 一 个 称 为 wxLayoutAlgorithm 的 类 来 完成 的 ， 这 个 类 
可 以 根据 父 窗口 的 不 同 提供 LayoutWindow，LayoutFrame， LayoutMDIFrame 等 多 种 不 同 的 
排列 方法 。 


你 还 可 以 使 用 wxSashLayoutWindow 类 ， 这 个 类 通过 wxQueryLayoutlnfoEvent 事 件 来 给 
wxLayoutAlgorithm 提 供 布 局 方向 和 尺寸 方面 的 信息 。 


关于 wxSashWindow，wxLayoutAlgorithm 和 wxSashLayoutWindow 更 多 的 信息 请 参考 手册 中 
的 相关 内 容 。wxSashWindow 不 允许 子 窗 口 被 移动 或 者 分 离 ， 因 此 在 不 久 的 将 来 ， 这 个 类 可 
能 被 一 个 通用 的 支持 合并 和 分 离 的 布局 框架 体系 所 代替 。 


下 图 演示 了 samples/sashtest 目 录 中 的 例子 在 windows 上 执行 的 效果 : 


®© Sash Demo 
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4.5 容器 窗口 95 


4.6 非 静 态 控件 


非 静态 控件 指 的 是 那些 可 以 响应 鼠标 和 键盘 事件 的 类 似 wxButton 和 wxListBox 之 类 的 控件 。 这 
里 我 们 会 对 其 中 最 基本 的 那些 进行 一 些 描述 。 更 高 级 的 内 容 被 安排 在 第 12 章 ， 你 可 以 参考 附 
录 E 中 的 方法 从 网 上 下 载 或 者 创建 你 自己 的 更 高 级 的 控件 。 


wxButton 


wxButton 控 件 看 上 去 象 是 一 个 物理 上 可 以 按 下 的 按钮 ， 它 拥有 一 个 文本 标签 ， 是 用 户 界 面 中 
最 常用 的 一 个 元 素 ， 它 可 以 被 放置 在 对 话 框 ， 或 者 面板 (wxPanel) 或 者 几乎 任何 其 它 的 窗口 
中 。 当 用 户 点 击 按钮 的 时 候 ， 会 产生 一 个 命令 类 型 的 事件 。 


下 面 是 创建 按钮 的 一 个 简单 的 例子 : 


#include "wx/button.h" 
wxButton* button = new wxButton(panel, wxID_OK, wxT("OK"), 
wxPoint(10, 10), wxDefaultSize); 


下 图 演示 了 按钮 在 Windows Xp 系统 上 的 默认 外 观 : 





wxWidgets 创 建 的 按钮 的 默认 大 小 是 依靠 静态 函数 wxButton::GetDefaultSize 指 定 的 ， 这 个 画 
数 在 不 同 的 平台 上 返回 不 同 的 值 。 不 过 你 可 以 通过 给 按钮 指定 wxBU_EXACTFIT 类 型 来 使 其 
产生 刚好 符合 其 标签 尺寸 的 大 小 。 


wxButton 的 窗口 类 型 
wxBU_LEFT 标签 文本 作对 齐 . 仅 适 用 于 Windows 和 GTK+ 平 台 . 
wxBU_TOP 标签 文本 上 对 齐 . 仅 适用 于 Windows 和 GTK+ 平 台 . 
wxBU_RIGHT 标签 文本 右 对 齐 。 仅 适用 于 Windows 和 GTK+. 


wxBU_BOTTOM 标签 文本 对 齐 按 钮 底部 . 仅 适 用 于 Windows 和 GTK+ 平 台 . 
wxBU_EXACTFIT ， 不 使 用 默认 大 小 创建 按钮 ， 而 是 按照 其 标签 文本 的 大 小 来 创建 按钮 . 
wxNO_BORDER ” 创建 一 个 平面 按钮 。 公 适用 于 Windows 和 GTK+ 平 台 . 

wxButton 的 事件 


wxButton 可 以 创建 类 型 为 wxCommandEvent 的 事件 ， 如 下 表 所 示 : 


用 于 人 处理 wxEVT_COMMAND_BUTTON_CLICKED 事 件 ,在 用 


EVT_BUTTON(id,func) 用 左 键 单 击 按 锤 的 时 候 产 生 . 


wxButtonAJAK A EBX 

wxButtonAy AK A EBX 

SetLabel| 和 GetLabel 函 数 用 来 操作 按钮 标签 文本 .你 可 以 使 用 "&" 前 导 符 来 指示 用 于 这 个 按钮 的 
快捷 键 ， 仅 适用 于 Windows 和 GTK+ 平 台 . SetDefault 将 按钮 设置 为 其 父 窗口 的 默认 按钮 ， 这 样 
用 户 按 回 车 键 就 相当 于 用 左 键 点 击 了 这 个 按钮. 


wxButton 的 标签 


你 可 以 使 用 一 个 前 导 符 "&" 来 指定 其 后 的 字符 为 这 个 按钮 的 快捷 键 ， 不 过 这 个 操作 仅 适 用 于 
Windows 和 GTK+ 的 版 本 ， 在 其 它 的 平台 上 ， 这 个 前 导 符 将 被 简单 的 忽略 。 


在 某 些 系 统 ， 尤 其 是 GTK+ 系 统 中 ， 例 如 确定 或 者 新 建 这 样 的 标准 按钮 的 标签 以 及 附带 显示 的 
一 些小 图 片 都 被 进行 了 默认 的 定义 。 在 wxWidgets 中 ， 通 常 你 只 需要 指定 这 个 按钮 的 标识 符 
为 系统 预定 义 的 标识 符 ， 那 么 这 些 预定 义 的 标签 和 小 图 片 将 被 显示 ， 不 过 ， 指 定 和 默认 值 不 
同 的 标签 文本 以 及 小 图 片 的 操作 都 是 允许 的 。 


推荐 的 对 于 这 些 预 定义 按钮 的 使 用 方法 如 下 ， 你 只 需要 指定 预定 义 的 标识 符 ， 不 需要 指定 标 
签 文本 ， 或 者 指定 标签 文本 为 空 字符 串 : 

wxButton* button = new wxButton(this, wxID_OK); 
wxWidgets 会 各 种 平台 提供 合适 的 标签 ， 在 上 面 的 例子 中 ， 在 windows 或 者 Mac OSX 平 台 


上 ， 将 使 用 字符 串 "&OK", 而 在 GTK+ 系 统 中 ， 会 使 用 当前 语言 下 的 OK 按钮 标签 。 然 后 如 果 你 
提供 了 自己 的 标签 文本 ， wxWidgets 将 会 按照 你 的 指示 办 事 : 


wxButton* button = new wxButton(this, wxID_OK, wxT("&Apply")); 


这 会 导致 无 论 在 哪 种 平台 上 ， 这 个 按钮 都 将 覆盖 标准 标识 符 的 定义 ， 使 用 "Apply" 作 为 这 个 按 
钮 的 标签 。 


你 可 以 使 用 wxGetStockLabel 男 数 ( 需 要 包含 wx/stockitem.h 这 个 头 文件 ) 来 获得 某 个 预定 义 窗 
口 标识 符 的 标签 ， 使 用 窗口 标识 符 和 true (如 果 你 希望 在 返回 的 结果 中 包含 前 导 符 (&)) 作为 
参数 . 


下 表 列 出 了 预定 义 标 识 符 和 其 默认 标签 的 对 应 关系 。 
预定 义 标识 符 预定 义 标 签 
wxlD_ADD "Add" 
wxID_APPLY "&Apply" 
wxID_BOLD "&Bold" 


wxID_ CANCEL "&Cancel" 


wxID_CLEAR 
wxID_CLOSE 
wxID_COPY 
wxID_CUT 
wxID_DELETE 
wxID_FIND 
wxID_REPLACE 
wxID_BACKWARD 
wxID_ DOWN 
wxID_FORWARD 
wxID_UP 
wxID_HELP 

wx!ID_ HOME 
wxID_INDENT 
wxID_INDEX 
wx!ID_ITALIC 
wxID_JUSTIFY_CENTER 
wxID_JUSTIFY_FILL 
wxID_ JUSTIFY _LEFT 
wxID_ JUSTIFY _RIGHT 
wxID_ NEW 

wxID_NO 

wxID_OK 
wxID_OPEN 
wxID_PASTE 

wxID_ PREFERENCES 
wxID_PRINT 
wxID_PREVIEW 
wxID_ PROPERTIES 
wxID_EXIT 

wxID_ REDO 
wxID_REFRESH 


"&Clear" 
"&Close" 
"&Copy" 
"Cu&t" 
"&Delete" 
"&Find" 
"Rep&lace" 
"&Back" 
"&Down" 
"&Forward" 
"&Up" 
"&Help" 
"&Home" 
"Indent" 
"&lndex" 
"&ltalic" 
"Centered" 
"Justified" 
"Align Left" 
"Align Right" 
"&New" 
"&No" 
"&OK" 
"&Open" 
"&Paste" 
"&Preferences" 
"&Print" 
"Print previe&w" 
"&Properties" 
"&Quit" 
"&Redo" 


"Refresh" 


wxID_REMOVE "Remove" 


wxID_REVERT_TO_SAVED "Revert to Saved" 
wxID_ SAVE "&Save" 
wxID_SAVEAS "Save &As..." 
wxID_STOP "&Stop" 
wxID_ UNDELETE "Undelete" 
wxID_ UNDERLINE "&Underline" 
wxID_UNDO "&Undo" 
wxID_UNINDENT "&Unindent" 
wxID_YES "&Yes" 
wxID_ZOOM_100 "&Actual Size" 
wxID_ZOOM_FIT "Zoom to &Fit" 
wxID_ZOOM_IN "Zoom &ln" 
wxID_ZOOM_OUT "Zoom &Out" 


wxBitmapButton 


和 普通 按钮 唯一 不 同 的 地 方 在 于 ， 它 将 显示 一 个 小 图 片 而 不 是 标签 文本 。 


下 面 演示 了 创建 一 个 图 片 按钮 的 方法 : 


#include "wx/bmpbuttn.h" 


wxBitmap bitmap(wxT("print.xpm"), wxBITMAP_TYPE_XPM); 


wxBitmapButton* button = new wxBitmapButton(panel, wxID_OK, 
bitmap, wxDefaultPosition, wxDefaultSize, wxBU_AUTODRAW); 


以 及 在 Windows 平 台 上 的 显示 效果 : 


&l 


片 按钮 通常 只 需要 指定 一 个 拥有 透明 


放 按 钮 状态 以 及 不 可 用 状态 等 。 


XPM 图 片 格式 是 推荐 的 图 片 格式 ， 因 为 它 可 以 很 容易 的 提供 透明 相关 的 信息 以 及 可 以 被 包含 
在 C++ 代码 中 。 不 过 加 载 别 的 格式 的 图 片 也 是 可 以 的 ， 比 如 常见 的 JPEG,PNG,GIF 以 及 BMP 


格式 。 


wxBitmapButton 的 窗口 类 型 


的 图 片 ，wxWidgets 将 会 在 任何 状态 的 时 候 都 使 用 
这 个 图 片 ， 不 过 如 果 你 愿意 ， 你 可 以 给 不 同 的 按钮 状态 指定 不 同 的 图 片 ， 比 如 选中 状态 ， 释 


如 果 指 定 了 这 个 类 型 ， 图 片 按 钮 将 只 会 使 用 标签 图 片 以 系统 默认 
的 方式 自动 被 绘制 ， 它 将 包含 边框 和 3D 的 外 观 。 如 果 没 有 指定 
这 个 类 型 ， 图 片 按钮 将 按照 不 同 状 态 提 供 的 不 同 的 图 片 来 进行 绘 
制 . 这 个 类 型 仅 适 用 于 Windows 和 Mac OS. 


wxBU_AUTODRAW 





wxBU_LEFT 图 片 左 对 齐 . 在 Mac OS 上 忽略 这 个 类 型 . 

wxBU_TOP 图 片 顶端 对 齐 . Mac OS 不 适用 . 

wxBU_RIGHT 图 片 右 对 齐 . Mac OS 不 适用 . 

wxBU_BOTTOM 图 片 底 端 对 齐 . Mac OS 不 适用 . 
wxBitmapButton 事 件 


片 按 钮 的 事件 和 wxButton 完 全 相同 . 
wxBitmapButton 的 成 员 函 数 


SetBitmapLabel 和 GetBitmapLabel 用 来 操作 按钮 的 主要 标签 图 片 . 你 还 可 以 使 用 
SetBitmapFocus, SetBitmapSelected, 和 SetBitmapDisabled 画 数 来 设置 按钮 被 激活 ， 被 按 下 
以 及 被 禁用 状态 下 对 应 的 图 片 。 


SetDefault 将 按钮 设置 为 其 父 窗口 的 默认 按钮 ， 这 样 用 户 按 回 车 键 就 相当 于 用 左 键 点 击 了 这 个 
按钮 . 


wxChoice 


选择 控件 由 一 个 只 读 的 文本 区 域 组 成 ， 这 个 区 域 的 文本 通过 对 一 个 附属 的 下 拉 列 表 框 中 值 进 
行 选 择 来 进行 赋值 。 这 个 下 拉 列 表 框 是 默认 不 可 见 的 ， 只 有 在 用 户 用 鼠标 点 击 下 拉 按 钮 以 后 


A — 
会 显 不 。 


创建 一 个 选择 控件 的 代码 如 下 ， 其 中 的 参数 含义 依次 为 : 父 窗口 ， 标 识 符 ， 位 置 ， 大 小 ， 窗 
口 类 型 以 及 文本 选项 。 


#include "wx/choice.h" 

wxArrayString strings; 

strings .Add(wxT("One")); 

strings .Add(wxT("Two")); 

strings .Add(wxT("Three") ); 

wxChoice* choice = new wxChoice(panel, ID_COMBOBOX, 
wxDefaultPosition, wxDefaultSize, strings); 


在 大 多 数 平 台 上 ， 除 了 文本 区 域 的 文本 是 只 读 的 以 外 ， 选 择 控件 和 wxComboBox( 如 下 图 所 示 ) 
是 非常 相似 的 。 在 GTK+ 平 台 上 ， 选 择 控件 是 一 个 拥有 一 个 下 拉 菜 单 的 按钮 。 你 可 以 用 过 设置 
wxComboBox 窗 口 的 只 读 属性 来 模拟 选择 控件 ， 以 便 能 够 使 得 在 选项 过 多 的 时 候 使 用 滚动 


条 。 


= FV 

Apple 

Orange 

Grapefruit 

wxChoice 的 窗口 类 型 
WxChoice 控 件 没有 特别 的 窗口 类 型 . 
WxChoice 的 事件 


wxChoice 控 件 产生 wxCommandEvent 类 型 的 事件 ， 如 下 表 所 示 : 


用 于 处 理 wx<EVT_COMMAND_CHOICE_SELECTED 事 件 , 当 有 


VI-CPOICE(Gune) 用 户 通过 列表 选择 某 个 选项 的 时 候 产 生 ， 


WxChoice 的 成 员 函 数 


WxChoice 相 关 的 成 员 函 数 都 是 前 面 介绍 过 的 wxControlWithltems 类 的 函数 ， 如 : Clear, 
Delete, FindString, GetClientData, GetClientObject, SetClientData, SetClientObject, 
GetCount, GetSelection, SetSelection, GetString, SetString, GetStringSelection, 
SetStringSelection, Insert, 和 lsEmpity. 


wxComboBox 


ComboBox 是 一 个 单行 编辑 框 和 一 个 列表 框 的 组 合 ， 用 来 允许 用 户 以 和 下 拉 框 中 的 文本 没有 
关系 的 方式 设置 或 者 获取 编辑 框 中 的 文本 。 其 中 的 单行 文本 域 可 以 是 只 读 的 ， 在 这 种 情况 下 
就 和 选择 控件 非常 相似 了 。 和 选择 控件 一 样 ， 通 常 列表 框 是 隐藏 的 ， 除 非 用 户 单 击 了 编辑 框 
旁边 的 小 按钮 。 这 个 控件 的 目 的 在 提供 一 种 紧凑 的 方法 给 用 户 ， 使 他 们 既 可 以 自己 输入 文 
本 ， 也 可 以 很 方便 的 选择 预定 义 好 的 文本 。 


创建 一 个 ComboBox 的 方法 和 创建 选择 控件 的 方法 很 类 似 ， 如 下 所 示 : 


#include "wx/combobox.h" 

wxArrayString strings; 

strings .Add(wxT("Apple") ); 

strings .Add(wxT("Orange")); 

strings.Add(wxT("Pear")); 

strings.Add(wxT("Grapefruit")); 

wxComboBox* combo = new wxComboBox(panel, ID_COMBOBOX, 
wxT("Apple"), wxDefaultPosition, wxDefaultSize, 
strings, wxCB_DROPDOWN) ; 


wxComboBox 的 窗口 类 型 


wxCB_SIMPLE IREK ET. 仅 适 用 于 Windows 和 平台 . \ 
wxCB_DROPDOWN ， 列表 框 下 拉 显 示 . 
和 wxCB_DROPDOWN 的 含义 相同 ， 只 不 过 编辑 框 的 文本 只 
wxCB_READONLY 能 通过 列表 框 进行 选择 ， 即 使 在 应 用 程序 的 代码 里 ， 也 不 人 允 
许 编辑 框 中 的 文本 不 存在 于 列表 框 内 。 
wxCB_SORT 列表 框 中 的 选项 自动 按照 子 母 顺序 排序 . 
wxComboBox 的 事件 
WxXComboBox 产 生 的 是 wxCommandEvent 类 型 的 事件 ， 如 下 表 所 示 : 


EVT_TEXT(id, func) 用 来 处 理 wxEVT_COMMAND_TEXT_UPDATED 事 件 , 当 编 辑 


框 内 文本 变化 时 产生 . 
EVT_COMBOBOX(id， ”用 来 处 理 wxEVT_COMMAND_COMBOBOX_SELECTED 事 
func) 件 ， 当 用 户 通过 列表 框 选 择 一 个 选项 的 时 候 产生 . 


wxComboBox 的 成 员 男 数 
除了 wxControlWithltems 的 成 员 函 数 以 外 ， 额 外 的 成 员 豆 数 还 包括 : 


Copy 男 数 闻 编辑 框 中 的 文本 拷贝 到 剪贴 板 ， Cut 函 数 除 了 作 Copy 郴 数 的 动作 ， 还 将 编辑 框 中 
的 文本 清空 ， Paste 函 数 则 把 剪贴 板 内 的 文本 复制 到 编辑 框 中 。 


GetinsertionPoint 函 数 返 回 当 前 编辑 框 中 插入 点 的 位 置 (长 整 型 ),SetinsertionPoint 则 用 来 设置 
这 个 位 置 .SetlnsertionPointEnd 用 来 将 其 设置 到 编辑 框 末尾 。 


GetLastPosition 返 回 编辑 框 中 的 最 后 位 置 。 


GetValue 函 数 用 来 返回 编辑 框 中 的 文本 ,SetValue 则 用 来 设置 它 . 如 果 combobox 拥 有 
wxCB_READONLY 类 型 ， 则 参数 中 的 文本 必须 在 列表 框 内 ， 否 则 在 发 表 版 本 中 ， 这 条 语句 将 
被 忽略 ， 而 在 调试 版 本 中 ， 则 会 出 现 一 个 告警 。 


SetSelection 用 来 设置 文本 框 中 的 一 部 分 为 选中 状态 ，Replace 则 将 文本 框 中 的 某 一 部 分 由 给 
定 的 参数 取代 。Remove 则 移 除 文本 框 中 的 给 定 部 分 . 


34 [Al xt BS wxControlWithltems # 643% EK A EA: Clear, Delete, FindString, GetClientData, 
GetClientObject, SetClientData, SetClientObject, GetCount, GetSelection, SetSelection, 
GetString, SetString, GetStringSelection, SetStringSelection, Insert, #1lsEmpty. 


wxCheckBox 
CheckBox 是 一 个 通常 拥有 两 种 状态 : 选中 或 者 未 选中 的 控件 。 通 常情 况 下 ， aes 
态 ， 则 控件 上 显示 一 个 小 的 叉 号 或 者 对 号 。 通 常 这 个 控件 还 包含 一 个 标签 ， 这 个 标签 可 以 显 


示 在 控件 的 左边 ， 也 可 以 显示 在 控件 的 右边 。 Se 姑且 
称 之 为 混合 状态 或 者 不 确定 状态 。 一 个 典型 的 用 法 是 在 安装 程序 中 ， 对 于 某 个 组 件 来 说 除了 
要 安装 和 不 要 安装 两 种 状态 以 后 ， 还 可 以 有 必须 安装 这 种 状态 。 


下 面 是 创建 CheckBox 的 例子 代码 : 


#include "wx/checkbox.h" 

wxCheckBox* checkbox = new wxCheckBox(panel, ID_CHECKBOX, 
wxT("&Check me"), wxDefaultPosition, wxDefaultSize); 

checkBox->SetValue(true); 


以 及 在 windows 平 台 上 控件 的 样子 : 


[V] Check me 
以 及 另外 的 一 个 三 态 的 wxCheckBox 第 三 态 的 样子 : 


[E] Indeterminate 


wxCheckBox 的 窗口 类 型 
wxCHK_2STATE 创建 一 个 二 态 选择 框 ， 这 是 默认 类 型 . 
wxCHK_3STATE 创建 一 个 三 态 选 择 框 . 


默认 情况 下 ， 用 户 是 不 能 设置 第 三 种 状 
态 的 ， 第 三 种 状态 只 能 在 程序 中 通过 代 
码 来 设置 ， 使 用 这 个 类 型 可 使 得 用 户 也 
可 以 通过 鼠标 设置 第 三 态 . 


wxALIGN_RIGHT 使 标签 显示 在 选择 框 的 左边 . 


wxCHK_ALLOW_3RD_STATE_FOR_USER 


wxCheckBox 的 事件 
wxCheckBox 产 生 wxCommandEvent 类 型 的 事件 ， 如 下 表 所 示 : 


EVT_CHECKBOX(id, 用 于 处 理 wxEVT_COMMAND_CHECKBOX_CLICKED 事 件 , 当 
func) wxCheckBox 的 选择 状态 改变 时 产生 . 


wxCheckBox 的 成 员 画 数 


SetLabel 和 GetLabel 用 来 设置 选择 框 的 标签 文本 . 在 Windows 和 GTK+ 平 台 上 ， 可 以 通过 "&" 前 
导 字 符 设 置 快 捷 键 . 


GetValue 和 SetValue 用 来 操作 Bool 型 的 当前 选择 状态 . 使 用 Get3StateValue 和 Set3StateValue 
来 操作 三 种 状态 wxCHK_ UNCHECKED, wxCHK_CHECKED,s 或 wxCHK_ UNDETERMINED. 


lIs3State 用 于 检测 是 否 是 三 态 选 择 框 。 
IsChecked 用 于 检测 当前 是 否 为 选中 状态 。 


wxListBox 和 wxCheckListBox 


wxListBox 用 来 从 一 组 基于 0 索引 的 字符 串 列表 中 选择 一 个 或 者 多 个 。 这 一 组 各 选 的 字符 串 列 
表 显 示 在 一 个 滚动 窗口 中 ， 选 中 的 文本 被 高 亮 显示 .列表 框 可 以 是 单 选 的 ， 这 种 情况 下 ， 如 果 
一 个 选项 被 选中 ， 以 前 被 选中 的 选项 就 自动 变 为 未 选中 状态 ， 也 可 以 是 多 选 框 ， 这 种 状态 
下 ， 对 某 个 选项 的 点 击 只 会 导致 这 个 选项 的 选中 状态 进行 切换 。 


使 用 下 面 的 代码 创建 一 个 列表 框 : 


#include "wx/listbox.h" 

wxArrayString strings; 

strings.Add(wxT("First string")); 

strings.Add(wxT("Second string")); 

strings.Add(wxT("Third string")); 

strings.Add(wxT("Fourth string")); 

strings.Add(wxT("Fifth string")); 

strings.Add(wxT("Sixth string")); 

wxListBox* listBox = new wxListBox(panel, ID_LISTBOX, 
wxDefaultPosition, wxSize(180, 80), strings, wxLB_SINGLE); 


在 windows 下 的 样子 : 


First string “A 
Second string 

Third string 

Fourth string 

Fifth string 


Sixth strina v 


wxCheckListBox 是 wxListBox 的 派生 类 ， 继 承 了 它 的 功能 ， 另 外 它 还 在 每 个 选项 上 额外 显示 一 
个 复 选 框 . 这 个 类 包含 在 头 文件 wx/checklst.h 中 ,下 图 演示 了 wxCheckListBox 控 件 在 windows 
上 的 样子 : 

First string 

v| Second string 

Third string 

Fourth string 

Fifth string 


| Sixth string 
Seventh string 


如 果 有 很 多 选项 要 显示 ， 你 可 以 考虑 使 用 wxVListBox。 这 是 一 个 虚 的 列表 框 类 ， 它 用 来 显示 
每 个 选项 的 方法 是 你 在 继承 自 这 个 类 的 派生 类 中 实现 的 OnDrawltem 画 数 和 OnMeasureltem 函 
数 ， 而 它 的 事件 映射 宏 的 格式 则 和 wxListBox 的 一 模 一 样 。 


wxHtmlListBox 就 是 一 个 wxVListBox 的 派生 类 ， 它 提供 了 显示 复杂 选项 的 一 种 简单 的 方法 。 你 
需要 定义 一 个 wxHtmlListBox 的 派生 类 ， 然 后 在 其 OnGetltem 画 数 中 ， 为 每 个 选项 定义 一 段 
HTML 文 本 ， 然 后 wxHtmlListBox 则 按照 这 段 HTML 文 本 来 显示 各 个 选项 。 下 图 演示 了 光盘 例 
子 samples/htlbox 在 Windows Xp 上 的 效果 ， 在 这 个 例子 中 ， 通 过 重 载 OnDrawSeparator 函 数 
实现 不 同 选项 的 不 同 显示 。 


i Html box wxWidgets Sample 
File Listbox Help 
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Item 817 10:00:36: Selected items: 10 
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wxListBox 和 wxCheckListBox 的 窗口 类 型 


wxLB_SINGLE 单 选 列表 . 
wxLB_MULTIPLE 多 选 列表 . 


wxLB_EXTENDED A OD At SS TUL AS 
wxLB_HSCROLL 创建 水 平 滚动 条 如 果 选 项 的 值 过 长 . Windows only. 
wxLB_ALWAYS SB 总 显示 垂直 滚动 条 . 

wxLB_NEEDED_SB REBRMWHRETREBAA 


条 . 
wxLB_SORT 所 有 选项 自动 按照 子 母 顺 序 排序 . 
wxListBox 的 wxCheckListBox 事 件 


wxListBox 和 wxCheckListBox 产 生 的 事件 类 型 wxCommandEvent 类 型 的 事件 . 
用 于 处 理 wxEVT_COMMAND_LISTBOX_SELECTED 事 
件 , 当 用 户 选 择 某 个 选项 的 时 候 产 生 . 


AF xB 
wxEVT_COMMAND_LISTBOX_DOUBLECLICKED33/4, 


EVT_LISTBOX(id, func) 


EVT_LISTBOX_DCLICK(id, 


tune) 当 某 个 选项 被 双击 的 时 候 产 生 
用 于 人 处理 
EVT_CHECKLISTBOX (id, wxEVT_COMMAND_CH ECKLISTBOX_TOGGLED#44, 
func) 当 wxCheckListBox 的 某 个 选项 的 选中 状态 发 生 改 变 的 时 
候 产 生 。 
wxListBox AX A EX 


Deselect 不 选 则 某 个 选项 。 GetSelections 使 用 wxArraylnt 类 型 返回 一 组 选中 的 索引 。 
Insertltems 用 来 插入 一 组 选项 ， 参 数 可 以 是 个 数 和 C++ 的 wxString 数 组 ， 以 及 插入 点 的 组 合 ， 
也 可 以 是 wxArrayString 对 象 和 插入 点 的 组 合 . 


Selected 用 来 判断 某 个 选项 是 否 被 选中 。 


Set 用 来 清除 选项 并 且 用 参数 中 的 选项 组 重 置 选项 。 参 数 可 以 是 个 数 和 C++ 的 wxString 数 组 ， 
以 及 插入 点 的 组 合 ， 也 可 以 是 wxArrayString 对 象 和 插入 点 的 组 合 . 


SetFirstltem 将 某 个 选项 设置 为 第 一 个 可 见 的 选项 。 
SetSelection 和 SetStringSelection 用 索引 或 者 字符 创 值 的 方式 指定 某 个 选项 的 选中 状态 


请 同时 参考 WxControlWithltems 的 下 列 成 员 画 数 : Clear, Delete, FindString, GetClientData, 
GetClientObject, SetClientData, SetClientObject, GetCount, GetSelection, GetString, 
SetString, GetStringSelection, Insert, 和 lsEmpty. 


wxCheckListBox 的 成 员 画 数 

除了 wxListBox 的 成 员 函 数 以 外 ，wxCheckListBox 还 另外 拥有 下 面 的 画 数 : 
Check 画 数 使 用 选项 索引 和 一 个 bool 值 作为 参数 也 控制 选项 的 选中 状态 
lsChecked 用 来 判断 某 个 选项 是 否 为 选中 状态 。 

wxRadioBox 


Radio Box 用 来 在 一 组 相关 但 是 互 斥 的 选项 中 进行 选择 。 通 常 显示 为 一 个 可 以 拥有 一 个 文本 标 
签 的 静态 框 中 的 一 组 垂直 的 或 者 水 平 的 选项 按钮 。 


选项 按钮 的 排列 方式 取决 于 构造 画 数 中 的 两 个 参数 ， 栏 数 和 方向 窗口 有 关 的 类 型 ， 方 向 
Sa ici ae Aa ia gt (默认 值 ) 和 wxRA_SPECIFY_ROWS, #4] 
来 说 ， 如 果 你 的 radio box 共 有 8 个 选项 ， 栏 数 为 2, 方 向 为 WXRA_SPECIFY_COLS， 和 那么 这 些 
选项 将 会 以 两 列 四 行 的 方式 显示 ， 而 假如 方向 为 wxRA_SPECIFY_ROWS， 则 显示 为 四 列 两 
行 。 


下 面 演示 了 怎样 创建 一 个 有 三 栏 的 RadioBox: 


#include "wx/radiobox.h" 

wxArrayString strings; 

strings .Add(wxT("&0One") ); 

strings .Add(wxT("&Two")); 

strings .Add(wxT("T&hree")); 

strings.Add(wxT("&Four ")); 

strings.Add(wxT("F&ive ")); 

strings .Add(wxT("&Six ")); 

wxRadioBox* radioBox = new wxRadioBox(panel, ID_RADIOBOX, 
wxT("Radiobox"), wxDefaultPosition, wxDefaultSize, 
strings, 3, wxRA_SPECIFY_COLS); 


以 及 它 在 windows 系 统 中 的 样子 : 


Radiobox 
@One OTwo O Thee 
OFfou OFve OSix 


wxRadioBox 的 窗口 类 型 


wxRadioBox 额 外 的 窗口 类 型 如 下 表 所 示 : 


wxRA_SPECIFY_ROWS 横向 分 栏 . 
wxRA_SPECIFIY_COLS 纵向 分 栏 . 
wxRadioBox 事 件 


wxRadioBox 产 生 wxCommandEvent 类 型 的 事件 ， 如 下 表 所 示 : 
EVT_RADIOBOX(id, ”用 来 处 理 wxEVT_COMMAND_RADIOBOX_SELECTED 事 件 , 当 
func) 用 户 点 击 选项 的 时 候 产 生 

wxRadioBox 成 员 画 数 

Enable 选 中 (或 不 选 ) 某 个 选项 . 

FindString 查 找 匹 配 的 选项 ， 返 回 这 个 选项 的 索引 或 者 WxXNOT_FOUND. 

GetCount 返 回 选 项 的 总 数 。 


GetString 和 SetString 用 来 操作 某 个 选项 的 标签 文本 . GetLabel 和 SetLabel 则 用 来 操作 整个 
radio box 的 标签 . 


GetSelection 返 回 基于 0 的 选中 的 选项 的 索引 . etnngS decion | ee 中 的 选项 的 标签 文 
A. SetSelection 和 SetStringSelection 则 用 来 设置 对 应 的 选项 ， 通 过 这 两 个 图 数 进行 设置 时 不 
会 发 送 任何 事件 。 


Show 函 数 用 来 显示 或 者 隐藏 某 个 特定 的 选项 或 者 整个 radio box 控 件 。 


wxRadioButton 


一 个 radio 按 钮 通常 用 来 表示 一 组 相关 但 是 互 斥 的 选项 中 的 一 个 ， 它 拥有 一 个 按钮 和 一 个 文本 

标签 ， 这 个 按钮 的 外 观 通常 是 一 个 圆 形 。 

radio 按 钮 有 两 种 状态 : 选中 和 未 选中 。 你 可 以 创建 一 组 radio 按 钮 来 代替 前 面 介绍 的 radiobox 

控件 ， 这 样 作 的 方法 是 ， 给 第 一 个 radio 按 钮 指定 wxRB_GROUP 类 型 ， 然 后 直到 另外 一 个 组 

被 创建 ， 或 者 没有 同 级 的 子 控件 的 时 候 ， 这 个 组 才 结 束 ， 组 中 的 控件 既 可 以 是 radio 按 钮 ， 也 

可 以 是 别 的 控件 。 

为 什么 要 代替 radiobox 呢 ， 其 中 一 个 原因 是 有 时 候 你 需要 使 用 更 复杂 的 布局 ， 例 如 ， 你 可 能 希 
望 给 每 一 个 radio 按 钮 增加 一 个 额外 的 描述 或 者 增加 一 个 额外 的 窗口 控件 ， 又 或 者 你 不 希望 在 

一 组 radio 周 围 显 示 一 个 静态 的 边框 等 。 


OMae O Female 


下 面 是 创建 一 组 〈 两 个 按钮 的 代码 ) 


#include "wx/radiobut.h" 

wxRadioButton* radioButtoni = new wxRadioButton (panel, 
ID_RADIOBUTTON1, wxT("&Male"), wxDefaultPosition, 
wxDefaultSize, wxRB_GROUP); 

radioButton1->SetValue(true); 

wxRadioButton* radioButton2 = new wxRadioButton (panel, 
ID_RADIOBUTTON2, wxT("&Female")); 

// 用 于 水 平 放置 两 个 按钮 的 布局 控件 使 用 的 代码 

wxBoxSizer* sizer = new wxBoxSizer (wxHORIZONTAL); 

sizer->Add(radioButton1, ©, wxALIGN_CENTER_VERTICAL|wxALL, 5); 

sizer->Add(radioButton2, ©, wxALIGN_CENTER_VERTICAL|wxALL, 5); 

parentSizer->Add(sizer, ©, wxALIGN_CENTER_VERTICAL|wxALL, 5); 


wxRadioButton 的 窗口 类 型 


wxRB_GROUP 用 来 标识 一 组 radio 按 钮 的 开始 . 
wxRB_USE_CHECKBOX 使 用 checkbox 的 按钮 取代 radio 按 钮 ( 仅 适 用 于 Palm OS). 
wxRadioButton 的 事件 
wxRadioButton 产 生 wxCommandEvent 类 型 的 事件 ， 如 下 表 所 示 : 
用 于 人 处理 


wxEVT_COMMAND_RADIOBUTTON_SELECTED 事 件 ， 
当 用 户 点 击 某 个 radio 按 钮 的 时 候 产生 。 


EVT_RADIOBUTTON(id, 
func) 


wxRadioButtonAy Ax A BAX 

GetValue 和 SetValue 使 用 bool 类 型 来 操作 radio 按 钮 的 状态 . 

wxScrollBar 

WxScrollBar 用 来 单独 的 增加 一 个 滚动 条 ， 这 个 滚动 条 和 某 些 窗口 自动 增加 的 两 个 滚动 条 是 有 
区 别 的 ， 但 是 它们 义理 事件 的 方式 是 一 样 的 。 滚 动 条 主要 有 下 面 四 个 属性 : 范围 (range), 滑 块 
大 小 ， 页 大 小 和 当前 位 置 。 

范围 的 含义 指 的 是 和 这 个 滚动 条 绑 定 的 窗口 的 逻辑 单位 的 大 小 。 上 比如 一 个 表格 有 15 行 ， 那 么 
和 这 个 表格 绑 定 的 滚动 条 的 范围 就 可 以 设置 为 15。 

滑 块 大 小 通常 用 来 反映 当前 可 视 部 分 的 大 小 ， 还 用 表格 来 作为 例子 ， 如 果 因为 窗口 大 小 的 原 
因 表 格 只 能 显示 5 行 ， 那 么 滚动 条 的 滑 块 大 小 就 可 以 设置 成 5。 如 果 滑 块 大 小 大 于 或 者 等 于 范 
围 ， 在 多 数 平台 上 ， 这 个 滚动 条 将 自动 隐藏 。 

页 大 小 指 的 是 当 滚 动 条 执行 翻 页 命令 时 需要 滚动 的 单位 数目 。 

当前 位 置 指 的 是 滑 块 当 前 所 处 的 位 置 。 


使 用 下 面 的 代码 来 创建 一 个 滚动 条 ， 其 中 构造 本 数 的 参数 含义 依次 为 父 窗 口 ， 标 识 符 ， 位 
置 ， 大 小 和 窗口 类 型 : 


#include "wx/scrolbar.h" 
wxScrollBar* scrollBar = new wxScrollBar (panel, ID_SCROLLBAR, 
wxDefaultPosition, wxSize(200, 20), wxSB_HORIZONTAL); 


在 windows 平 台 上 ， 显 示 结 果 如 下 图 所 示 : 


< > 


创建 一 个 滚动 条 以 后 ， Raa JAGR E GAIEI. BEN 
wxScrolledWindowh at (3 G24 47 24 3k SAY E. 


wxScrollBar 的 窗口 类 型 
wxSB_HORIZONTAL 指定 滚动 条 为 水 平方 向 . 
wxSB_VERTICAL 指定 滚动 条 为 垂直 方向 . 
wxScrollBar 的 事件 


wxScrollBar 产 生 wxScrollEvent 类 型 的 事件 。 你 可 以 使 用 EVT_COMMAND_SCROLL... 事 件 映 
射 宏 加 窗口 标识 符 来 拦截 由 特定 滚动 条 产生 的 相关 事件 ， 或 者 使 用 EVT_SCROLL... 不 带 窗 口 
标识 符 的 事件 映射 宏 来 拦截 除了 本 窗口 以 外 来 自 其 他 的 窗口 的 滚动 条 事件 。 使 用 
EVT_SCROLL(func) 可 以 响应 所 有 的 滚动 条 事件 。 在 附录 | 命 事 件 类 型 和 相关 宏 命 中 详细 列举 
了 所 有 的 滚动 事件 ， 你 也 可 以 参考 手册 中 的 相关 内 容 。 


wxScrollBarBy Ak % WE 

Getrange 返 回 范围 大 小 . 

GetPageSize 返 回 页 大 小 .通常 这 个 大 小 和 滑 块 大 小 相同 。 
GetThumbPosition 和 SetThumbPosition 用 来 操作 滑 块 当前 位 置 
GetThumbLength 返 回 滑 块 或 者 当前 可 是 区 域 的 大 小 . 


SetScrollbar 用 来 设置 滚动 条 的 所 有 属性 .比如 滑 块 位 置 (逻辑 单位 ) , 滑 块 大 小 ， 范 围 ， 页 大 
小 以 及 一 个 可 选 的 bool 参 数 用 来 指示 是 否 立 即 更 新 滚动 条 的 显示 。 


wxSpinButton 


WwWxSpinButton 拥 有 两 个 小 的 按钮 用 来 表示 上 下 或 者 左右 .这 个 控件 通常 和 一 个 文本 编辑 框 控件 
一 起 使 用 ， 以 用 来 增加 或 者 减少 某 个 值 。 为 了 方便 移植 ， 应 该 尽 可 能 使 用 wxSpinCtrl 来 代替 
wxSpinButton, 因 为 不 是 所 有 的 平台 都 支持 wxSpinButton. 


这 个 控件 (以 及 wxSpinCtrl) 所 支持 的 值 的 范围 是 平台 相关 的 ， 但 是 至 少 在 -32768 到 32768 之 
间 ， 


使 用 下 面 的 代码 来 创建 一 个 wxSpinButton, 其 中 构造 函数 的 参数 的 含义 分 别 为 : 父 窗口 ， 标 识 
符 ， 位 置 ， 大 小 以 及 窗口 类 型 : 


#include "wx/spinbutt.h" 
wxSpinButton* spinButton = new wxSpinButton(panel, ID_SPINBUTTON, 
wxDefaultPosition, wxDefaultSize, wxSP_VERTICAL); 


在 windows 平 台 上 ， 显 示 的 结果 如 下 图 所 示 : 


A 


wxSpinButton 的 窗口 类 型 
下 表 列 出 了 wxSpinButton 的 窗口 类 型 


wxSP_HORIZONTAL spin 按 钮 为 左右 方向 . 不 支持 wxGTK. 
wxSP_VERTICAL spin 按 钮 为 上 下 垂直 方向 . 
wxSP_ARROW_KEYS ”用 户 可 以 使 用 方向 键 来 改变 相关 值 . 


将 最 大 值 和 最 小 值 首尾 相连 ， 比 如 最 小 值 的 更 小 的 下 一 个 值 料 


wxSP_WRAP 是 最 大 值 . 


xii xl 


wxSpinButton 的 事件 
wxSpinButton 产 生 wxSpinEvent 类 型 的 事件 , 如 下 表 所 示 : 


用 来 处 理 wxEVT_SCROLL _THUMBTRACK 事 件 , 当 上 下 (或 


EVT_SPIN(id, func) | £E) 按 甸 被 点 直 的 时 候 产生 . 


EVT_SPIN_UP(id, 用 来 人 处理 wxEVT_SCROLL _LINEUP 事 件 , 当 向 上 (或 者 向 左 ) 
func) 的 按钮 被 点 击 的 时 候 产生 . 

EVT_SPIN_DOWN(id， ”用 来 处 理 wxEVT_SCROLL _LINEDOWN 事 件 , 当 向 下 (或 者 向 
func) A) 按钮 被 点 击 的 额 时 候 产 生 . 


wxSpinButton 的 成 员 函 数 


GetMax 返 回 设置 的 最 大 值 . GetMin 返 回 设置 的 最 小 值 . GetValue 和 SetValue 用 来 操作 当前 值 . 
SetRange 用 来 设置 最 大 和 最 小 值 . 


wxSpinCtrl 


wxSpinCtrl 是 wxTextCtrl 和 wxSpinButton 控 件 的 组 合 。 当 用 户 点 击 wxSpinButton 的 向 上 或 者 向 
下 按钮 的 时 候 ，wxTextCtrl 中 的 值 将 会 随 之 变化 。 用 户 也 可 以 直接 在 wxTextCtrl 中 输入 他 想 
的 值 。 


下 面 的 代码 用 来 创建 一 个 值 范围 在 0 到 100 之 间 ， 初 始 值 为 5 的 wxSpinCtrl。 


#include "wx/spinctr1.h" 

wxSpinCtr1* spinCtrl = new wxSpinCtrl(panel, ID_SPINCTRL, 
wxT("5"), wxDefaultPosition, wxDefaultSize, wxSP_ARROW_KEYS, 
0, 100, 5); 


在 windows 平 台 上 的 显示 效果 如 下 图 所 示 : 
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wxSpinCtrl 的 窗口 类 型 
wxSP_ARROW_KEYS 用 户 可 以 通过 方向 键 改 变相 关 值 . 
wxSP_WRAP 将 最 大 值 和 最 小 值 首尾 相连 . 
wxSpinCtrl 事 件 


WXSpinCtrl 产 生 wxSpinEvent 类 型 的 事件 ， 如 下 表 所 示 . 你 也 可 以 使 用 EVT_TEXT 事 件 映 射 宏 
来 处 理 其 文本 框 的 文本 更 新 事件 ， 人 处理 画 数 的 额 参 数 类 型 为 wvxCommandEvent. 


Handles a wxEVT_SCROLL_THUMBTRACK event, 


EVASRINGgp tune) generated whenever the up or down arrow is clicked. 


EVT_SPIN_UP(id, Handles a wxEVT_SCROLL_LINEUP event, generated when 
func) the up arrow is clicked. 

EVT_SPIN_DOWN(id, Handles a wxEVT_SCROLL_LINEDOWN event, generated 
func) when the down arrow is clicked. 

EVT_SPINCTRL(id, 


func) Handles all events generated for the wxSpinCtrl. 


wxSpinCtrlAx A EEX 


GetMax 返 回 设置 的 最 大 值 . GetMin 返 回 设置 的 最 小 值 . GetValue 和 SetValue 用 来 操作 当前 值 . 
SetRange 用 来 设置 最 大 值 和 最 小 值 . 
wxSlider 


slider 控 件 拥 有 一 个 滑 条 和 一 个 滑 块 ， 可 以 通过 移动 滑 条 上 的 滑 块 来 改变 控件 的 当前 值 . 
使 用 下 面 的 代码 创建 一 个 取 值 范围 为 0 到 40, 初 始 位 置 为 16 的 wxSlider. 


#include "wx/slider.h" 

wxSlider* slider = new wxSlider(panel, ID_SLIDER, 16, 0, 40, 
wxDefaultPosition, wxSize(200, -1), 
wxSL_HORIZONTAL | wxSL_AUTOTICKS |wxSL_LABELS) ; 


在 windows 平 台 上 显示 的 外 观 如 下 所 示 : 
[ie 0 ] 40 


wxSlider 的 窗口 类 型 


wxSL_HORIZONTAL 显示 水 平方 向 的 滑 条 . 

wxSL_VERTICAL 显示 垂直 方向 的 滑 条 . 

wxSL_AUTOTICKS 显示 刻度 标记 . 

wxSL_LABELS 显示 最 大 、 最 小 以 及 当前 值 的 标签 . 

wxSL_LEFT 对 于 垂直 滑 条 ， 将 刻度 显示 在 左面 . 

wxSL_RIGHT 对 于 垂直 滑 条 ， 将 刻度 显示 在 右面 . 

wxSL_TOP 对 于 水 平滑 条 ， 刻 度 显示 在 上 面 . 默认 值 为 显示 在 底部 . 
wxSL_SELRANGE 人 允许 用 户 通过 滑 条 选择 一 个 范围 . 仅 适 用 于 Windows. 


wxSlider 的 事件 


wxSlider 产 生 wxCommandEvent 类 型 的 事件 ,如 下 表 所 示 , 但 是 如 果 你 希望 更 好 的 控制 ， 你 可 以 
使 用 EVTCOMMAND_SCROLL... 宏 ， 其 处 理 画 数 的 参数 类 型 为 wxScrollEvent， 参 见 附录 |. 


EVT_SLIDER(id, 用 于 处 理 wxEVT_COMMAND_ SLIDER_U PDATED 事 件 , 当 用 户 移动 
func) 滑 块 的 时 候 产 生 . 
wxSlider 的 成 员 函 数 


ClearSel 用 来 在 设置 了 wxSL _SELRANGE 类 型 的 滑 条 上 清除 选择 区 域 . ClearTicks 则 用 来 清除 
刻度 ， 仅 适用 于 windows 系 统 . 


GetLineSize 和 SetLineSize 用 来 操作 移动 单位 ， 这 个 移动 单位 用 来 在 用 户 使 用 方向 键 操 作 滑 块 
的 时 候 使 用 . ee ae 作 移 动 单位 ， 这 个 单位 在 用 户 用 鼠标 点 击 
滑 条 的 任 一 边 的 时 候 使 用 . 


GetMax 返 回 当 前 设置 的 最 大 值 . 
GetMin 返 回 当 前 设置 的 最 小 值 . 


GetSelEnd 和 GetSelStart 用 来 返回 选择 区 域 的 起 点 和 终点 ; SetSelection 用 来 设置 选择 区 域 的 
起 点 和 终点 . ERS BSB RIS AF Windows. 


GetThumbLength 和 SetThumbLength 用 来 操作 滑 块 的 大 小 . 


GetTickFreq 和 SetTickFreq 用 来 操作 滑 条 上 刻度 的 密度 .SetTick 用 来 设置 刻度 的 位 置 。 这 些 画 
数 仅 适用 于 Windows. 


GetValue 返 回 滑 条 的 当前 值 , SetValue 用 来 设置 滑 条 的 当前 值 . 
SetRange 用 来 设置 滑 条 的 最 大 值 和 最 小 值 . 


wx TextCtrl 


文本 控件 是 用 来 显示 和 编辑 文本 的 控件 ， 它 支持 单行 和 多 行 的 文本 编辑 。 在 某 些 平 台 上 ， 支 
持 给 文本 控件 中 的 文本 设置 一 些 简 单 的 格式 和 风格 。 在 windows 平 台 ，GTK+ 和 平台 以 及 Mac 
OS X 平 台 上 通过 使 用 wxTextAttr 类 来 设置 和 获取 文本 的 当前 格式 。 


使 用 下 面 的 代码 创建 一 个 支持 多 行文 本 的 文本 框 控件 : 


#include "wx/textctrl.h" 

wxTextCtr1* textCtrl = new wxTextCtrl(panel, ID_TEXTCTRL, 
wxEmptyString, wxDefaultPosition, wxSize(240, 100), 
wxTE_MULTILINE); 


在 windows 平 台 上 ， 多 行文 本 框 控件 的 外 观 如 下 : 





The rain in Spain stays mainly in the plain. In A 
Hertfordshire, hurricanes hardly ever happen. 


When in Rome, do as the Romans do. 


When in Edinburgh, for goodness’ sake wrap 
up warmly. v 


多 行文 本 框 人 允许 使 用 以 \n" 分 割 的 一 组 文本 行 的 方式 来 处 理 一 段 广 本， 即使 在 非 Unix 的 平台 
上 ， 使 用 "\n" 作 为 分 割 符 也 是 允许 的 。 这 使 得 你 可 以 忽略 平 台 之 间 换 行 符 的 差异 。 不 过 ， 作 为 
代价 ， 你 将 不 能 直接 使 用 那些 GetinsertionPoint 函 数 或 者 GetSelection 画 数 返 回 的 索引 ， 作 为 
GetValue 返 回 的 字符 串 中 的 索引 ， 因 为 在 前 者 返回 的 索引 中 ， 操 作 系 统 可 能 会 进行 了 一 点 点 
的 偏 移 以 便 对 点 上 平台 使 用 的 \r\n" 换 行 符 ， 就 象 windows 平 台 上 的 那样 。 


如 果 你 想 从 上 面 例子 的 范 数 的 返回 值 中 得 到 一 个 子 字符 串 应 该 怎么 办 呢 ? 你 可 以 使 用 
GetRange 画 数 。 它 们 返回 的 索引 可 以 被 用 于 它们 自 己 别 的 成 员 画 数 ， 上 比如 SetiInsertionPoint 
或 者 SetSelection。 总 而 言 之 ， 不 要 将 用 多 行文 本 框 的 成 员 本 数 返回 的 索引 直接 用 于 它 的 内 容 
字符 串 的 索引 ， 但 是 可 以 将 其 用 于 其 它 成 员 函 数 作为 参数 。 


多 行文 本 框 支持 设置 文本 格式 : 你 可 以 为 部 分 文本 设置 单独 的 文本 颜色 和 字体 。 在 windows 平 
台 上 ， 这 需要 窗口 使 用 wxTE_RICH 窗口 类 型 。 你 可 以 在 插入 文本 之 前 使 用 SetDefaultStyle 画 
数 ， 或 者 在 插入 文本 以 后 使 用 SetStyle 来 改变 已 经 存在 于 文本 框 中 的 文本 的 格 式 。 前 者 更 有 
效率 。 


无 论 在 哪 种 情况 下 ， 如 果 指 定 的 格式 中 的 部 分 格式 是 没有 被 指定 的 ， 则 默认 格式 中 相应 的 值 
将 被 使 用 ， 如 果 没 有 默认 的 格式 ， 那 个 文本 控件 自己 的 属性 将 会 被 使 用 。 


在 下 面 的 代码 中 ， 第 二 次 调用 SetDefaultStyle 不 会 改变 文本 的 前 景 颜 色 (DASE), RA 
一 次 调用 SetDefaultStyle 则 不 会 改变 文本 的 背景 颜色 (仍然 是 灰色 的 ) 。 


text ->SetDefaultStyle(wxTextAttr(*wxRED) ); 
text->AppendText(wxT("Red text\n")); 

text ->SetDefaultStyle(wxTextAttr(wxNullColour, *wxLIGHT_GREY)); 
text ->AppendText(wxT("Red on gray text\n")); 

text ->SetDefaultStyle(wxTextAttr(*wxBLUE) ); 

text ->AppendText(wxT("Blue on gray text\n")); 


wxTextCtrl 的 窗口 类 型 


wxTE_PROCESS_ENTER 


wxTE_PROCESS_TAB 


wxTE_MULTILINE 
wxTE_PASSWORD 
wxTE_READONLY 


wxTE_RICH 


wxTE_RICH2 


wxTE_AUTO_URL 


wxTE_NOHIDESEL 


WwxHSCROLL 


wxTE_LEFT 
wxTE_CENTRE 
wxTE_RIGHT 
wxTE_DONTWRAP 


wxTE_LINEWRAP 


wxTE_WORDWRAP 
wxTE_NO_VSCROLL 


wxTextCtrl 的 事件 


这 个 控件 将 会 产生 wxEVT_COMMAND _TEXT_ENTER 事 
件 .如 果 没 有 设置 这 个 类 型 ， 回 车 键 闻 会 或 者 被 空 家 内 部 处 
理 ， 或 者 被 dialog 窗 口 用 来 通 历 所 有 子 窗口 . 


这 个 控件 将 会 在 TAB 键 被 按 下 的 时 候 处 理 wxEVT_CHAR 事 
件 ,否则 TAB 键 用 来 在 dialog 的 所 有 子 窗口 之 间 通 万 . 


支持 多 行文 本 . 

MAYALL" Bm. 

文本 只 读 . 

在 Windows 下 使 用 语文 本 编辑 控件 . 这 将 允许 控件 存储 超 
过 64KB 的 文本 ;并 且 垂 直 滚 动 条 自动 在 需要 的 时 候 显 示 . 这 
个 类 型 在 别 的 平台 上 将 被 忽略 . 


在 Windows 下 使 用 富 文本 编辑 控件 的 2.0 或 者 3.0 版 本 ; 垂直 
滚动 条 将 始终 被 显示 . 在 其 它 平 台 忽 略 这 个 类 型 . 


高 亮 显示 URL 字 符 串 ， 并 且 在 其 被 点 击 的 时 候 产生 
wxTextUrlEvents 事 件 . 在 windows 平 台 上 需要 设置 
wxTE_RICH 类 型 . 仅 适用 于 Windows 和 GTK+ 平 台 . 


默认 情况 下 ， 在 windows 平 台 上 ， 如 果 文 本 框 当前 没有 得 


到 焦点 ， 将 不 会 高 之 显示 文本 框 中 文本 的 选中 部 分 ， 使 用 
这 个 类 型 可 以 使 其 即使 在 文本 框 没有 获得 焦点 的 时 候 ， 被 


选 部 分 也 会 高 亮 显 示 。 其 它 平台 则 忽略 这 个 类 型 。 


显示 水 平 滚动 条 ， 这 样 就 不 需要 文本 自动 换行 了 . 在 
GTK+ 平 台 上 无 效 . 


文本 框 中 的 文本 左 对 齐 (默认 ). 
文本 框 中 的 文本 居中 对 齐 . 
文本 框 中 的 文本 右 对 齐 . 

等 同 于 wxHSCROLL 类 型 . 


如 果 文 本 行 的 长 度 超出 可 以 显示 的 部 分 ， 则 人 允许 在 文本 行 
的 任何 位 置换 行 ， 目 前 只 支持 wxUniversal 版 本 . 


如 果 文 本 行 的 长 度 超出 可 以 显示 的 部 分 ， 则 人 允许 在 文本 行 
的 单词 边界 位 置换 行 ， 目 前 只 支持 wxUniversal 版 本 . 


Removes the vertical scrollbar. No effect on GTK+. 


wxTextCtrl 主 要 产生 wxCommandEvent 类 型 的 事件 ， 如 下 表 所 示 : 


用 于 处理 wxEVT_COMMAND_TEXT_UPDATED 事 件 ,文本 
框 内 文本 值 改变 的 时 候 产 生 . 


用 于 处 理 wxEVT_COMMAND_TEXT_ENTER 事 件 ,在 用 户 按 
下 回 车 键 的 时 候 产 生 并 且 文 本 框 设置 了 
wxTE_PROCESS_ENTER 窗 口 类 型 . 


EVT_TEXT(id, func) 


EVT_TEXT_ENTER(id, 
func) 


用 于 人 处理 wxEVT_COMMAND _TEXT_MAXLEN 事 件 , 当 用 户 
试图 输入 的 文本 长 度 超过 SetMaxLength 设 置 的 长 度 的 时 候 
产生 . 仅 适 用 于 Windows 和 GTK+ 和 平台 . 


EVT_TEXT_MAXLEN(id, 
func) 


wxTextCtrl AJ AK A RIŽ 


AppendText 将 文本 添加 在 文本 框 最 后 , WriteText 在 当前 的 插入 点 插入 文本 . SetValue 清 除 文本 
框 中 的 当前 文本 然后 赋值 ,赋值 后 IsSModified 画 数 返回 False. 在 所 有 这 些 范 数 中 ， 如 果 文 本 框 支 
持 多 行文 本 ， 则 可 以 使 用 换行 符 。 需 要 注意 这 些 范 数 都 会 产生 文本 更 新 事件 . 


GetValue 男 数 返 回 文本 框 的 所 有 文本 ， 如 果 是 多 行文 本 类 型 ， 则 其 中 可 以 包含 换行 符 . 
GetLineText 返 回 其 中 一 行 . GetRange 返 回 某 个 位 置 范 围 内 的 文本 。 


Copy 男 数据 贝 选 中 的 文本 到 剪贴 板 . Cut 除 了 Copy 以 外 还 清除 选中 的 文本 . Paste 则 将 剪贴 板 上 
的 文本 替换 当前 的 选中 文本 ， 在 用 户 界 面 刷 新 事件 义理 函数 中 ， 你 还 可 以 使 用 CanCopy， 
CanCut#llCanPasteH 2X. 


Clear 清 除 所 有 文本 .产生 文本 更 新 事件 。 
DiscardEdits 复 位 内 部 的 售 已 修改 银 标 记 ， 就 好 像 文 本 框 的 文本 已 经 被 保存 了 那 祥 。 
EmulateKeyPress 用 来 模拟 按键 输入 ， 以 便 在 文本 框 中 进行 某 些 修改 . 


GetdefaultStyle 和 SetDefaultStyle 用 来 操作 当前 的 默认 文本 格式 . GetStyle 返 回 某 个 位 置 文本 
的 当前 格式 ,SetStyle 则 用 来 设置 某 个 范围 内 的 文本 格式 e. 


当 Be nt de edi 
GetLineLength 返 回 某 个 特定 行 的 字符 创 长 度 。 
GetNumberOfLines 返 回 总 行 数 。 


GetStringSelection 返 回 当前 选中 的 文本 。 如 果 当 前 没有 选中 任何 文本 ， 则 返回 空 字 符 串 。 
GetSelection 返 回 当 前 选中 部 分 的 索引 . SetSelection 则 用 两 个 整数 参数 来 设置 当前 的 选中 部 
分 。 


IsEditable 返 回 当 前 控件 是 否 可 以 被 编辑 . SetEditable 用 来 设置 控件 的 可 编辑 状态 以 便 让 其 只 
读 或 者 可 编辑 . IsModified 当 文本 框 内 的 文本 已 经 被 编辑 过 的 时 候 返 回 True. lsMultiline 用 来 检 
测 当 前 文本 框 是 否 是 多 行文 本 框 。 


LoadFile 将 文件 内 容 读 入 文本 框 , SaveFile 将 文本 框 内 容 存 入 文件 . 


PositionToXY 将 象 素 值 转换 成 文本 的 行 号 和 位 置 , 而 XYToPosition 则 刚好 相反 。 
Remove 删 除 给 定 区 域 的 文本 ，. Replace 则 替换 给 定 区 域 的 文本 。 
ShowPosition 使 得 文本 控件 显示 包含 给 定位 置 的 部 分 。 


Undo 撤 消 最 近 一 次 编辑 , Redo 重 复 最 近 一 次 编辑 . 在 某 些 平台 这 些 操作 可 能 什么 也 不 作 . 
你 可 以 用 CanUndo 和 CanRedo 来 测试 当 前 的 平台 是 否 支 持 撤消 和 重 做 动作 。 


wxToggleButton 


wxToggleButton 在 用 户 点 击 以 后 保持 按 下 状态 . 换 句 话说 ， 除 了 长 的 象 按钮 ， 它 其 实 更 可 以 说 


是 一 个 wxCheckBox. 


创建 WxToggleButton 的 代码 如 下 : 


#include "wx/tglbtn.h" 

wxToggleButton* toggleButton = new wxToggleButton(panel, ID_TOGGLE, 
wxT("&Toggle label"), wxDefaultPosition, wxDefaultSize) ; 

toggleButton->SetValue(true); 


下 图 则 显示 了 其 在 windows 平 台 上 的 样子 : 





wxToggleButton 的 窗口 类 型 

wxToggleButton 没 有 特别 的 窗口 类 型 . 
wxToggleButton 事 件 

wxToggleButton 产 生 wxCommandEvent 类 型 的 事件 。 


用 于 处 理 


i wxEVT_COMMAND_TOGGLEBUTTON_CLICKED#/4, 
用 户 点 击 该 按钮 的 时 候 产生 . 


wxToggleButton 的 成 员 画 数 


SetLabel 和 GetLabel 用 来 操作 按钮 上 的 标签 . 在 windows 和 GTK+ 平 台 上 你 可 以 使 用 "&" 前 导 符 
来 指定 一 个 加 速 键 


GetValue 和 SetValue 用 来 获取 和 设置 按钮 的 状态 。 


4.7 静态 控件 


静态 控件 不 响应 任何 用 户 输入 ， 只 用 来 显示 一 些 信息 或 者 增加 占用 程序 的 美感 。 
进度 条 


这 是 一 个 水 平 或 者 垂直 的 用 来 显示 进度 (通常 是 时 间 的 进度 ) 的 控件 。 它 不 产生 任何 命令 事 
件 。 下 面 的 代码 用 来 创建 一 个 进度 条 : 


= 


#include "wx/gauge.h" 
wxGauge* gauge = new wxGauge(panel, ID_GAUGE, 

200, wxDefaultPosition, wxDefaultSize, wxGA_HORIZONTAL) ; 
gauge->SetValue(50); 


在 windows 平 台 上 的 外 观 : 
wxGauge 的 窗口 类 型 


wxGA_HORIZONTAL ”水 平 进 度 条 . 


wxGA_VERTICAL 垂直 进度 条 
创建 一 个 光滑 的 进度 条 ， 进 度 条 的 每 一 段 之 间 没 有 空格 . 仅 适用 


wxGA_SMOOTH 于 Windows. 


wxGauge 事 件 

因为 进度 条 只 是 用 来 显示 信息 ， 因 此 不 产生 任何 事件 。 
wxGauge 成 员 画 数 

GetRange 和 SetRange 用 来 设置 进度 条 的 最 大 值 。 
GetValue 和 SetValue 用 来 获取 和 设置 进度 条 的 当前 值 。 
lsVertical 用 来 检测 是 否 是 垂直 进度 条 (否则 就 是 水 平 的 ) 。 
wxStaticText 

静态 文本 控件 用 来 显示 一 行 或 者 多 行 的 静态 文本 。 

下 面 的 例子 创建 了 一 个 静态 文本 控件 : 


#include "wx/stattext.h" 

wxStaticText* staticText = new wxStaticText(panel, wxID_STATIC, 
wxT("This is my &static label"), 
wxDefaultPosition, wxDefaultSize, wxALIGN_LEFT); 


以 及 它 在 windows 平 台 上 的 外 观 : 
This is my static label 


在 静态 文本 控件 标签 中 的 前 导 符 "&"， 在 某 些 平台 (比如 Windows 和 GTK+) 上 用 来 定义 一 个 
快捷 键 ， 通 过 这 个 快捷 键 可 以 直接 访问 到 下 一 个 非 静 态 的 控件 。 


wxStaticText 的 窗口 类 型 


wxALIGN_LEFT 标签 左 对 齐 . 
wxALIGN_RIGHT 标签 右 对 齐 . 
wxALIGN_CENTRE 标签 在 水 平方 向 上 居中 对 齐 . 


默认 情况 下 ， 静 态 文 本 控件 会 在 调用 SetLabel 以 后 自动 改变 
大 小 以 使 得 其 大 小 刚好 满足 标签 文本 的 需要 ， 如 果 设 置 了 这 
wxST_NO_AUTORESIZE ”个 类 型 ， 则 标签 不 会 改变 自己 的 大 小 。 通 常 这 个 类 型 应 该 和 

SRN y 类 型 一 起 使 用 因为 如 果 没 有 设置 这 个 类 型 ， 自 动 
调整 大 小 使 得 对 齐 没有 任何 意义 。 

wxStaticTexthU Ax A EB 

GetLabel 和 SetLabel 用 户 获取 和 设置 文本 标签 。 

wxStaticBitmap 


静态 图 片 控件 显示 一 个 图 片 。 
使 用 下 面 的 代码 创建 静态 图 片 控件 。 


#include "wx/statbmp.h" 

#include "print.xpm" 

wxBitmap bitmap(print_xpm); 

wxStaticBitmap* staticBitmap = new wxStaticBitmap(panel, wxID_STATIC, 
bitmap); 


这 会 在 作为 父 窗口 的 面板 或 者 对 话 框 上 显示 一 个 图 片 ， 如 下 图 所 示 : 


wxStaticBitmap 的 窗口 类 型 

没有 特别 的 窗口 类 型 . 

wxStaticBitmap 的 成 员 画 数 
GetBitmap 和 SetBitmap 用 来 获取 和 设置 其 显示 的 图 片 。 


wxStaticLine 


这 个 控件 用 来 在 其 父 窗口 上 显示 一 个 水 平 或 者 垂直 的 长 条 ， 以 便 作为 子 窗口 的 静态 分 割 条 。 


下 面 是 创建 wxStaticLine 的 代码 : 


#include "wx/statline.h" 
wxStaticLine* staticLine = new wxStaticLine(panel, wxID_STATIC, 
wxDefaultPosition, wxSize(150, -1), wxLI_HORIZONTAL); 


以 及 其 在 windows 平 台 上 的 外 观 : 


wxStaticLine 的 窗口 类 型 
wxLI_HORIZONTAL 水 平 长 条 . 
wxLl_VERTICAL 垂直 长 条 . 


wxStaticLine 的 成 员 画 数 
lsVertical 用 来 检测 是 否 为 垂直 长 条 . 
wxStaticBox 


这 个 控件 用 来 在 一 组 控件 周围 显示 一 个 静态 的 拥有 一 个 可 选 标签 的 矩形 方 框 。 到 目前 为 止 ， 
这 个 控件 不 可 以 作为 其 它 控件 的 父 窗口 。 它 围绕 的 那些 控件 是 它 的 的 兄弟 窗口 而 非 子 窗口 。 
它们 应 该 在 它 后 面 创建 ， 但 是 它们 拥有 同样 的 父 窗口 。 在 将 来 的 版 本 中 ， 也 许 会 更 改 这 个 限 
制 以 便 它 可 以 同时 容纳 兄弟 窗口 和 子 窗口 。 


下 面 是 创建 一 个 wxStaticBox 的 例子 代码 : 


#include "wx/statbox.h" 
wxStaticBox* staticBox = new wxStaticBox(panel, wxID_STATIC, 
wxT("&Static box"), wxDefaultPosition, wxSize(100, 100)); 


以 及 它 在 windows 平 台 上 的 样子 : 


Static box 


wxStaticBox 的 窗口 类 型 
没有 特别 的 窗口 类 型 
wxStaticBox 的 成 员 画 数 


GetLabel 和 SetLabel 用 来 获取 和 设置 其 静态 标签 。 


4.8 菜单 


在 这 一 小 节 中 ， 我 们 来 介绍 一 下 怎样 使 用 wxMenu, 它 用 一 种 相对 简单 的 办 法 来 提供 一 组 命 兮 
但 是 却 不 占用 大 量 的 空间 。 在 下 一 小 节 ， 我 们 会 描述 一 下 怎样 在 菜单 条 上 使 用 菜单 。 


wxMenu 


菜单 是 指 的 一 串 命 售 ， 它 可 以 从 菜单 条 弹出 ， 也 可 以 从 任何 一 个 窗口 上 作为 关联 菜单 ， 通 过 

常 是 右键 单 击 来 弹出 。 菜 单项 可 以 是 一 个 普通 的 命 舍 ， 也 可 以 是 一 个 复 选 框 或 者 是 一 个 单 
选 框 。 菜 单项 可 以 被 茶 用 ， 这 是 它 将 不 能 触发 任何 命令 。 某 些 菜单 项 可 以 通过 一 下 特殊 的 三 
角 符 号 来 带 出 一 个 新 的 菜单 ， 菜 单 中 有 可 以 有 新 的 特殊 菜单 项 ， 这 种 循环 可 以 使 用 任意 多 
次 。 另 外 一 种 特殊 的 菜单 项 是 一 个 分 割 条 ， 它 只 是 简单 的 显示 一 行 或 者 一 段 空白 以 便 把 两 组 
菜单 项 进行 分 割 。 


下 图 显示 了 一 个 典型 的 拥有 普通 菜单 项 ， 复 选 框 ， 单 选 框 以 及 子 菜单 的 菜单 : 


File Edit 
New...  Ctrl+Nh 
Open Ctrl+O 


w Checked 


@ Radio 1 
Radio 2 
Radio 3 


Item Two 


上 面 的 例子 还 演示 了 两 种 快捷 操作 方法 : 加 速 键 和 快捷 键 。 加 速 键 是 通过 ea ig sacs 
使 用 下 划 线 表示 ， 当 菜单 显示 的 时 候 可 以 通过 这 个 键 来 执行 相应 的 命 分 。 而 快捷 键 则 是 

组 合 键 ， 它 可 以 在 菜单 没有 显示 的 时 候 执 行 菜单 命 售 ， 它 通过 一 个 TAB 加 一 个 组 合 键 被 定义 。 
例如 ， 上 图 中 的 New 菜 单 是 通过 下 面 的 代码 实现 的 : 


menu->Append(wxID_NEW, wxT("&New...\tCtrl+N")); 


更 多 通过 菜单 或 者 wxAcceleratorTable 创 建 快 捷 键 的 方法 将 会 在 第 6 章 说 明 。 


菜单 中 的 复 选 框 和 单 选 框 的 状态 是 由 菜单 类 自动 维护 的 。 它 们 会 在 单 击 的 时 候 自 动 将 自己 的 

状态 改变 ， 并 且 在 下 一 次 菜单 展示 的 时 候 以 新 的 状态 展示 。 对 于 单 选 框 来 说 ， 在 改变 自己 状 
态 的 同时 ， 它 还 会 将 其 它 同一 组 中 的 单 选 框 更 改 为 未 选中 的 状态 。 你 也 可 以 在 自己 的 代码 中 
置 它们 的 状态 (参考 第 9 章 ) 。 


你 可 以 通过 wxWindow::PopupMenu 男 数 闻 某 个 菜单 在 一 个 窗口 的 特定 位 置 星 示 ， 上 比如 下 面 的 
代码 : 


void wxWindow: :OnRightClick(wxMouseEvent& event) 
if (!m_menu) 
m_menu = new wxMenu; 
m_menu->Append(wxID_OPEN, wxT("&Open")); 
m_menu->AppendSeparator(); 
m_menu->Append(wxID_EXIT, wxT("E&xit")); 


PopupMenu(m_menu, event.GetPosition()); 


菜单 事件 在 发 送 给 它 的 父 窗口 以 及 进行 其 它 的 事件 表 匹 配 之 前 会 首先 发 送 给 菜单 自己 。 
PopupMenu 枉 数 会 导致 程序 短暂 堵塞 ， 直 到 用 户 关 闭 这 个 菜单 。 如 果 你 愿意 ， 你 可 以 每 次 都 
释放 旧 的 并 且 重 新 创建 新 的 菜单 ， 也 可 以 每 次 都 使 用 同一 个 菜单 。 


你 应 该 尽 可 能 的 使 用 系统 预定 义 的 菜单 标识 符 ， 比 如 wxID_OPEN, wxID_ABOUT, 
wxID_PRINT 等 等 ， 在 第 三 章 中 有 一 个 完整 的 列表 。 需 要 特别 指出 的 是 ， 在 Mac OS X 上 ， 标 
识 符 为 wxID_ABOUT, wxID_PREFERENCES 和 wxID_EXIT 的 菜单 项 不 是 显示 在 你 定义 的 菜 
单 中 ， 而 是 显示 在 系统 菜单 中 ，wxWidgets 自 动 为 你 的 菜单 作 了 这 个 调整 。 但 是 你 需要 注意 在 
调整 以 后 不 要 留 下 类 似 空 的 帮助 菜单 ， 或 者 是 两 个 菜单 分 割 条 连 在 一 起 这 样 的 不 专业 的 情况 
出 现 。 


在 wxWidgets 的 发 行 版 的 例子 中 的 samples/menu 例 子 演 示 了 所 有 菜单 的 功能 ， 而 在 另外 一 个 
samples/ownerdrw 例 子 中 ， 则 演示 了 怎样 在 菜单 中 使 用 定制 的 字体 和 图 片 。 


wxMenu 的 事件 


wxMenu 相 关 的 事件 类 型 总 共有 四 种 : wxCommandEvent, wxUpdateUIEvent, wxMenuEvent， 
和 wxContextMenuEvent. 


下 表 列 出 了 处理 函 数 使 用 wxCommandEvent 作 为 参数 类 型 的 事件 映射 宏 。 可 用 其 来 处 理 菜单 
命令 ， 无 论 是 弹出 菜单 命令 还 是 主 菜 单 (来 自 类 似 Frame 窗 口 的 菜单 条 上 的 菜单 ) 命令 。 这 种 
事件 宏和 工具 条 上 的 事件 映射 宏 是 一 致 的 ， 这 使 得 菜单 和 工具 条 上 的 按钮 产生 的 事件 可 以 通 

过 同一 个 处 理事 数 处 理 。 


用 来 处 理 wxEVT_COMMAND_MENU_SELECTED 事 件 , 某 
个 菜单 项 被 选中 的 时 候 产 生 . 


EVT_MENU_RANGE(id1， ”用 来 处 理 wxEVT_COMMAND_MENU_RANGE 事 件 ,在 某 个 
id2, func) 范围 内 的 菜单 项 被 选中 的 时 候 产 生 . 


EVT_MENU(id, func) 
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是 在 系统 空闲 的 时 候 产生 的 ， 以 便 给 应 用 程序 一 个 更 新 用 户 界 面 的 机 会 。 例 如 ， 人 允许 或 者 禁 
止 一 个 菜单 项 等 。 尽 管 wxUpdateUIEvent 可 以 被 任何 窗口 产生 ， 但 是 菜单 产生 的 
wxUpdateUIEvent 还 是 有 一 些 不 同 的 地 方 ， 在 于 在 这 个 事件 中 可 以 调用 Check 辑 数 ，SetText 
画 数 和 Enable 画 数 等 。Check 画 数 用 来 选中 或 者 不 选 某 个 菜单 项 ， 而 SetText 男 数 用 来 设置 菜 
单项 的 标签 。 如 果菜 单项 的 标签 需要 根据 某 种 条 件 动态 改变 的 话 会 比较 有 用 。 例 如 : 


BEGIN_EVENT_TABLE(MyFrame, wxFrame) 

EVT_UPDATE_UI(ID_TOGGLE_TOOLBAR, MyFrame: :OnUpdateToggleToolbar ) 
END_EVENT_TABLE( ) 
void MyFrame: :OnUpdateToggleToolbar (wxUpdateUIEvent& event) 





{ 
event.Enable(true); 
event .Check(m_showToolBar ); 
event.SetText(m_showToolBar ? 
wxT("Show &Toolbar (shown)") : 
wxT("Show &Toolbar (hidden)")); 
} 


用 来 处 理 wxEVT_UPDATE_UI 事 件 . 22H AA Lua 
用 Enable, Check, 和 SetText 以 及 其 它 辑 数 . 


EVT_UPDATE_UI_RANGE(id1， ”用 来 处 理 wxEVT_UPDATE_U| 事 件 ， 以 便 同时 处 理 一 
id2, func) 组 标识 符 . 


EVT_UPDATE_UI(id, func) 


关于 界面 更 新 的 更 多 详情 请 参考 第 9 章 。 


下 表 列 出 另外 一 些 事件 映射 宏 ， 其 中 EVT_CONTEXT_MENU 的 参数 类 型 为 
wxContextMenuEvent， 这 是 一 个 从 WwxCommandEvent 继 承 的 事件 类 型 ， 因 此 这 个 事件 可 以 
在 父子 窗口 继承 关系 中 传播 。 使 用 这 个 宏 来 拦截 类 似 鼠 标 右键 单 击 以 产生 关联 菜单 的 事件 ， 
然后 调用 事件 的 GetPosition 函 数 来 获得 菜单 应 该 显示 的 准确 位 置 。 剩 下 的 事件 映射 宏 的 处 理 
函数 采用 wxMenuEvent 对 象 作为 参数 ， 这 些 事件 只 从 菜单 条 发 送 给 其 frame 窗 口 ， 来 告诉 应 用 
程序 一 个 菜单 已 经 被 打开 或 者 关闭 了 ， 或 者 某 个 菜单 项 正 被 高 之 显示 ， 默 认 的 
EVT_MENU_HIGHLIGHT 的 处 理 画 数 是 在 主 程序 的 状态 栏 显 示 这 个 菜单 项 的 帮助 信息 ， 不 过 
你 可 以 提供 你 自己 的 处 理 函 数 来 作 一 些 不 同 的 事情 。 


用 来 处 理由 于 用 户 或 者 通过 某 个 特殊 按键 
(在 windows 平 台 上 ) ， 或 者 通过 单 击 她 标 
EVT_CONTEXT_MENU(func) 右键 产生 的 弹出 一 个 上 下 文 菜单 的 请 求 。 处 
EB py AVS Bl He AY A 
wxContextMenuE vent. 


EVT_COMMAND_CONTEXT_MENU(id, 和 EVT_CONTEXT_MENU 相 似 ,不 过 多 了 一 
func) 个 窗口 标识 符 参 数 . 


用 来 处 理 wxEVT_MENU_OPEN 事 件 , 在 一 个 
菜单 即将 被 打开 的 时 候 产 生 。 在 windows 平 

台 上 主 菜单 上 每 次 通 历 只 会 导致 一 次 这 个 事 
件 产生 . 


FJ pe 
EVT_MENU_CLOSE(func) ae pol coke ty aa BTE 


EVT_MENU_OPEN(func) 


用 来 处 理 wxEVT_MENU_HIGHLIGHT 事 件 ， 
当 某 个 菜单 项 被 高 之 显示 的 时 候 产 生 ， 通 常 


EVT_MENU_HIGHLIGHT(id, func) 用 来 在 主 程序 的 状态 栏 上 产生 关于 这 个 菜单 
项 的 帮助 信息 。 
用 来 处 理 wxEVT_MENU_HIGHLIGHT 事 
EVT_MENU_HIGHLIGHT_ALL(func) 件 ， 在 任何 一 个 菜单 项 被 高 之 显示 的 时 候 产 
生 。 
wxMenu 的 成 员 画 数 


Append 增 加 一 个 菜单 项 : 参数 为 标识 符 ,菜单 项 标签 , 帮助 信息 和 菜单 项 类 型 
(wxITEMNORMAL, wxITEM_SEPARATOR, wxITEM_CHECK 或 wxITEM RADIO). 你 也 可 以 
使 用 AppendCheckltem 和 AppendRadioltem 来 避免 手动 指定 wxITEM_CHECK 或 
wxlITEM_RADIO 参 数 类型. 例如: 


// 增加 一 个 普通 菜单 项 

menu->Append(wxID_NEW, wxT("&New...\tctrl+N")); 

// 增加 一 个 复 选 框 菜单 项 

menu->AppendCheckItem(ID_ SHOW_ STATUS, wxT("&Show Status")); 

// 增加 一 个 单 选 框 菜单 项 

menu->AppendRadioItem(ID PAGE MODE, wxT("&Page Mode")); 

Another overload of Append enables you to append a submenu, for example: 
// 增加 一 个 子 菜单 

menu->Append(ID_SUBMENU， wxT("&More options..."), subMenu); 


还 有 一 种 Append 的 重 载 画 数 允 许 你 直接 使 用 一 个 wxMenultem 来 增加 一 个 菜单 项 ， 这 是 在 菜 
单 中 增加 图 片 或 者 使 用 自 定义 字体 唯一 的 方法 : 


// 初始 化 图 片 和 字体 

wxBitmap bmpEnabled, bmpDisabled; 

wxFont fontLarge; 

// 创建 一 个 菜单 项 

wxMenuItem* pItem = new wxMenuItem(menu, wxID_OPEN, wxT("&Open...")); 
/ 设置 图 片 和 字体 

pItem->SetBitmaps(bmpEnabled, bmpDisabled); 
pItem->SetFont(fontLarge); 

// 增加 到 菜单 中 

menu->Append(pItem); 


使 用 Insert 范 数 来 在 特定 的 位 置 插 入 一 个 菜单 项 。 使 用 Prepend, PrependCheckltem, 
PrependRadioltem 和 PrependSeparator 在 菜单 最 开始 的 地 方 插入 一 个 菜单 项 。 


AppendSeparator 插 入 一 个 分 割 条 , InsertSeparator 在 特定 位 置 插 入 一 个 分 割 条 . 


// 插入 一 个 分 割 条 


menu->AppendSeparator(); 
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使 用 Check 画 数 是 标记 复 选 框 或 者 单 选 框 的 状态 。 参 数 为 菜单 项 标识 符 和 一 个 bool 值 。 使 用 
IsChecked 函 数 来 获取 当前 状态 . 


Delete 函 数 删除 并 且 释 放 一 个 菜单 项 使 用 菜单 项 标识 符 或 者 WwxMenultem 指 和 针 。 如 果 这 个 菜单 
项 是 一 个 子 菜单 ， 则 子 菜单 将 不 被 删除 。 如 果 你 想 删 除 并 且 释 放 一 个 子 菜单 ， 使 用 Destroy 画 
数 。Remove 函 数 移 除 一 个 菜单 项 但 是 并 不 释放 它 ， 而 是 返回 指向 它 的 指针 。 


使 用 Enable 函 数 来 允许 或 者 禁止 一 个 菜单 项 。 但 是 比 直 接 调 用 这 个 方法 更 好 的 作法 是 处 理 用 
户 界面 更 新 事件 (参考 第 9 章 ) 。|sEnabled 辑 数 返 回 当 前 的 可 用 状态 


使 用 Findltem 函 数 根 据 标签 或 者 标识 符 找到 一 个 菜单 项 ， 使 用 FindltemByPosition 函 数 通 过 位 
置 找 到 一 个 菜单 项 。 


GetHelpString 和 SetHelpString 函 数 用 来 访问 菜单 项 的 帮助 信息 . 当 菜 单 是 菜单 条 的 一 部 分 时 ， 
高 亮 显示 的 菜单 项 的 帮助 信息 将 会 显示 在 状态 栏 上 。 


GetLabel 和 SetLabel 用 来 获取 或 者 设置 菜单 项 的 标签 . 

GetMenuCount 返 回 菜单 项 的 个 数 。 
GetMenultems 返 回 一 个 wxMenultemList 类 型 的 菜单 项 的 列表 。 

GetTitle 和 SetTitle 用 来 获取 或 者 设置 菜单 的 可 选 标题 ， 这 个 标题 通常 只 在 弹出 菜单 中 有 意义 。 


UpdateUl 发 送 用 户 界 面 更 新 事件 到 其 参数 只 是 的 事件 处 理 对 象 ， 如 果 参 数 为 NULL 则 发 往 菜单 
的 父 窗 口 .这 个 函数 在 菜单 即将 显示 之 前 会 被 调用 ， 但 是 应用 程序 也 可 以 在 自己 认为 需要 的 时 
候 调用 它 。 


4.9 控制 条 


控制 条 提供 了 一 个 比较 直观 而 方便 的 方法 来 排列 多 个 控件 。 目 前 有 三 种 类 型 的 控制 条 ， 分 别 
是 : 菜单 条 ， 工 具 条 和 状态 条 ， 其 中 菜单 条 只 能 在 frame 窗 口上 使 用 ， 工 具 条 和 状态 条 通常 也 
是 在 frame 窗 口上 使 用 ， 不 过 它们 也 可 以 作为 别 的 窗口 的 子 窗口 。 


wxMenuBar 


菜单 条 包含 一 系列 的 菜单 ， 显 示 在 frame 窗 口 顶 部 标题 栏 的 下 方 。 你 可 以 通过 调用 
SetMenuBar 函 数 覆 盖 frame 窗 口 当前 的 菜单 条 ， 使 用 下 面 的 代码 创建 一 个 菜单 条 : 


wxMenuBar* menuBar = new wxMenuBar; 

wxMenu* fileMenu = new wxMenu; 

fileMenu->Append(wxID_OPEN, wxT("&Open..."), wxT("Opens a file")); 
fileMenu->AppendSeparator(); 

fileMenu->Append(wxID_EXIT, wxT("E&xit"), wxT("Quits the program")); 
menuBar ->Append(fileMenu) ; 

frame->SetMenuBar(menuBar, wxT("&File")); 


上 述 代 码 创 建 了 一 个 只 有 一 个 菜单 的 菜单 条 ， 如 下 图 所 示 : 





em My frame 


你 可 以 给 菜单 增加 子 菜单 ， 也 可 以 在 菜单 上 增加 单 选 框 和 复 选 框 ， 还 可 以 给 菜单 项 增加 快捷 
键 和 加 速 键 〈 请 参考 本 章 前 一 章节 的 内 容 ) 。 


如 果 你 提供 了 一 个 帮助 字符 创 ， 那 么 默认 的 EVT_MENU_HIGHLIGHT 枉 数 会 将 其 显示 到 
frame 的 窗口 的 状态 栏 上 (如 果 有 的 话 ) 。 


wxMenuBar 的 窗口 类 型 


wxMenuBar 拥 有 一 个 wxMB_DOCKABLE 类型， 在 GTK+ 平 台 上 人 允许 菜单 条 从 主 窗口 分 离 出 
来 。 


wxMenuBar 事 件 
参考 本 章 前 一 小 节 中 的 相关 内 容 。 
wxMenuBar 成 员 函 数 


Append 画 数 在 菜单 条 的 末尾 增加 一 个 菜单 项 ， 一 且 菜 单项 被 成 功 增加 ， 那 么 它 将 被 菜单 条 管 
理 并 且 在 合适 的 时 候 被 释放 。 这 个 函数 参数 为 要 增加 的 菜单 以 及 一 个 标签 。Insert 函 数 则 在 给 
定 的 位 置 插入 一 个 菜单 。 


Enable 酌 数 允 许 或 者 禁止 给 定 标识 符 的 菜单 项 . 使 用 IsEnabled 函数 判断 菜单 项 是 否 被 允许 . 


Check ait BRAK 个 复 选 框 或 者 单 选 框 菜单 项 . 使 用 lsChecked 函 数 来 获 前 的 
先 择 状态 。 


EnableTop 函 数 人 允许 或 者 禁止 一 整个 菜单 。 参 数 为 基于 0 的 菜单 索引 。 


FindMenu 使 用 给 定 的 标签 字符 串 查找 某 个 菜单 ， 其 中 参数 字符 串 可 以 带 有 前 导 字 符 也 可 以 不 
带 有 前 导 字 符 . 如 果 找 不 到 则 返回 wxNOT_FOUND. 


FindMenultem 通 过 菜单 名 和 菜单 项 返回 菜单 项 的 索引 。 


Findltem 通 过 给 定 的 菜单 项 标识 符 返 回 wxMenultem 类 型 的 菜单 项 ， 如 果 这 个 菜单 项 是 一 个 子 
菜单 ， 那 么 第 二 个 参数 将 会 返回 这 个 子 菜单 的 指针 。 


GetHelpString 和 SetHelpString 用 来 获取 或 者 设置 某 个 菜单 项 的 帮助 信息 。 
GetLabel 和 SetLabel 用 来 设置 某 个 菜单 项 的 标签 ， 


GetLabelTop 和 SetLabelTop 用 来 获取 和 设置 某 个 菜单 在 菜单 条 上 的 标签 ， 参 数 为 基于 0 的 索 
Bl. 


GetMenu 根 据 素 引 返 回 对 应 菜单 指针 ， 

GetMenuCount 返 回 菜单 条 上 所 有 菜单 的 个 数 ， 

Refresh 重 画 菜单 条 。 

Remove 移 除 一 个 菜单 项 并 且 返 回 对 应 的 菜单 指针 ， 然 后 用 户 应 该 自己 释放 这 个 已 经 移 除 的 菜 
单 。 

Replace 函 数 则 将 某 个 位 置 的 菜单 使 用 新 的 菜单 代替 并 且 返 回 老 的 菜单 的 指针 。 用 户 应 该 自 
己 释 放 这 个 老 的 菜单 ， 

wxToolBar 


工具 条 用 来 放置 各 种 按钮 和 控件 。 工 具 条 可 以 是 水 平 的 也 可 以 是 垂直 的 ， 其 上 的 按钮 可 以 是 
单 选 ， 复 选 以 及 push 按 钮 。 这 些 按钮 可 以 显示 标签 也 可 以 显示 图 片 。 如 果 你 使 用 
wxFrame::CreateToolBar 画 数 创建 工具 条 ， 或 者 使 用 wxFrame::SetToolBar 函 数 将 你 创建 的 工 

BRA frame 窗 口 绑 定 ， 那 么 frame 窗 口 将 会 管理 这 个 工具 条 的 位 置 和 大 小 以 及 释放 ， 并 且 工 
具 条 的 大 小 也 不 算 作 frame 的 客户 区 大 小 。。 任 何其 它 方法 创建 的 工具 条 ， 你 都 需要 自己 使 用 
布局 控件 或 者 其 它 方法 来 来 负责 这 个 工具 条 的 位 置 和 大 小 ， 


下 面 是 创建 工具 条 以 及 和 frame 窗 口 绑 定 的 例子 代码 : 


#include "wx/toolbar.h" 

#include "open.xpm" 

#include "save.xpm" 

wxToolBar* toolBar = new wxToolBar(frame, wxID_ANY, 
wxDefaultPosition, wxDefaultSize, wxTB_HORIZONTAL |wxNO_BORDER) ; 

wxBitmap bmpOpen(open_xpm); 

wxBitmap bmpSave(save_xpm); 

toolBar->AddTool(wxID_OPEN, bmpOpen, wxT("Open")); 

toolBar ->AddTool(wxID_SAVE, bmpSave, wxT("Save")); 

toolBar ->AddSeparator(); 

wxComboBox* comboBox = new wxComboBox(toolBar, ID _COMBOBOX); 

toolBar ->AddControl1(comboBox) ; 

toolBar->Realize(); 

frame->SetToolBar(toolBar); 


在 windows 平 台 上 的 外 观 如 下 图 所 示 : 


me = 
i 4 v 


注意 调用 Realize 之 前 ， 所 有 位 于 其 上 的 按钮 和 控件 应 该 已 经 被 增加 到 了 工具 条 中 ， 否 则 工具 
条 上 将 什么 也 不 会 显示 。 


你 可 以 查看 wxWidgets 的 samples/toolbar 中 的 例子 ， 来 了 解 怎样 更 改 工具 条 的 方向 ， 增 加 显示 
按钮 上 的 标签 以 及 更 改 按钮 的 大 小 等 等 其 它 方面 的 内 容 。 


Windows 平 台 上 工具 按钮 上 的 图 片 的 颜色 


在 windows 平 台 上 ，wxWidgets 试 图 将 工具 按钮 上 的 图 片 的 颜色 映射 到 当前 桌面 风格 下 的 标准 
ma. PK, TRE (lightgray) 用 来 表示 透明 颜色 。 下 表 列 出 了 所 有 这 些 颜 色 。 事 实 
上 ， 工 具 按 钮 上 的 图 片 的 颜色 只 需要 接近 于 标准 颜色 。 接 近 意 味 着 RGB 三 原色 的 值 和 标准 颜 
色 的 值 差别 在 10 个 单位 范围 内 。 


颜色 值 颜色 名 ”用 于 

wxColour(0, 0, 0) 黑色 深 色 阴影 

wxColour(128, 128, 128) RIK 亮 物体 的 3 维 边 缘 的 阴 面 

wxColour(192, 192, 192) IK 3 维 物体 的 表面 (按钮 背景 ), 表示 透明 区 域 
wxColour(255, 255, 255) 白色 之 物体 的 3 维 边 缘 的 高 完 面 


对 于 16 色 的 图 片 来 说 ， 这 中 映射 是 没有 问题 的 ， 但 是 如 果 你 使 用 的 是 颜色 更 丰富 的 按钮 图 片 
其 至 真 彩 图 片 ， 那 么 这 种 映射 可 能 会 让 你 的 按钮 上 的 图 片 变 的 非常 妖 陋 ， 在 这 种 情况 下 ， 你 
可 以 使 用 下 面 的 代码 禁止 这 种 映射 : 


wxSystemOptions: :SetOption(wxT("msw.remap"), 0); 


要 使 用 上 面 的 代码 ， 你 需要 包含 "wx/sysopt.h" 头 文件 。 


wxToolBar 的 窗口 类 型 


wxTB_HORIZONTAL = 创建 水 平 工具 条 . 
条 . 


wxTB_VERTICAL 创建 垂直 工具 

wxTB_FLAT 给 工具 条 一 个 浮动 外 观 . Windows and GTK+ only. 
wxTB_DOCKABLE 使 得 工具 条 可 以 支持 浮动 和 放置 . GTK+ only. 
wxTB_TEXT 显示 按钮 上 的 标签 ;默认 情况 下 只 显示 图 标 . 
wxTB_NOICONS 不 显示 按钮 上 的 图 标 ;默认 情况 下 是 显示 的 . 
wxTB_NODIVIDER 指示 工具 条 上 没有 分 割 线 . Windows only. 


指示 文本 显示 在 图 片 的 旁边 而 不 是 下 面 . 仅 适用 于 Windows 和 


wxTB_HORZ_LAYOUT | GTK+. 这 个 类 型 必须 和 wxTB_TEXT 共 同 使 用 . 


wxTB_HORZ_TEXT 是 wxTB_HORZ_LAYOUT 和 wxTB_TEXT 的 组 合 . 


wxToolBar 的 事件 


工具 条 事件 映射 宏 如 下 表 所 示 。 象 前 面 说 过 的 那样 ， 工 具 条 的 事件 宏和 菜单 的 事件 宏 是 完 
一 样 的 ， 你 既 可 以 使 用 EVT_MENU 宏 ， 也 可 以 使 用 EVT_TOOL 宏 。 它 们 的 事件 处 理 画 数 的 参 
数 类 型 都 是 wxCommandEvent。 对 于 它们 中 的 大 多 数 来 说 ， 窗 口 标识 符 指 的 都 是 工具 按钮 的 
窗口 标识 符 ， 只 有 EVT_TOOL_ENTER 事 件 宏 的 窗口 标识 符 指 的 是 工具 条 的 窗口 标识 符 ， 而 
对 应 的 工具 按 包 的 窗口 标识 符 要 从 wxCommandEvent 事 件 中 获取 ， 这 是 因为 在 表示 鼠标 离开 
一 个 工具 按钮 的 时 候 ， 窗 口 标识 符 可 能 为 -1, 而 在 wxWidgets 的 事件 体系 中 是 不 允许 标识 符 为 -1 
的 。 


用 于 处 理 wxEVT_COMMAND_TOOL_CLICKED 事 
件 (和 wxEVT_COMMAND_MENU_SELECTED 的 


PVT TOQBA fune) 值 相同 ), 在 用 户 点 击 工具 按钮 的 时 候 产 生 . 在 宏 中 使 


用 工具 按钮 的 标识 符 . 
EVT_TOOL RANGE(id1, id2, 用 于 处理 一 组 工具 按钮 标识 符 的 
func) wxEVT_COMMAND_ TOOL_CLICKED 事 件 . 


FAF 44 #2wxEVT_COMMAND_TOOL_RCLICKED 
EVT_TOOL_RCLICKED(id, func) ， 事件 ,用 户 在 工具 按钮 上 点 击 右 键 的 时 候 产生 .使 用 工 


具 按 钮 的 窗口 标识 符 . 
EVT_TOOL_RCLICKED_RANGE ”用 于 处理 一 组 工具 按钮 标识 符 的 
(id1, id2, func) wxEVT_COMMAND_TOOL _RCLICKED 事 件 . 


用 于 人 处理 wxEVT_COMMAND_TOOL_ENTER 事 件 ， 
用 户 的 鼠标 移入 或 者 移出 某 个 工具 按钮 的 额 时 候 产 
EVT_TOOL_ENTER(id, func) 生 ， 宏 中 使 用 工具 条 的 窗口 标识 符 ， 使 用 
WxCommandEvent::GetSelection 函 数 来 获得 移入 
的 工具 按钮 的 标识 符 ， 如 果 是 移出 则 这 个 值 是 -1 


wxToolBar 的 成 员 画 数 


AddTool 增 加 一 个 工具 按钮 :指定 按钮 的 标识 符 ,一 个 可 选 的 标签 ,一 个 图 片 ,一 个 帮助 信息 ,以 及 
按钮 的 类 型 (wxITEM_NORMAL, wxITEM_CHECK, 或 者 wxITEM_RADIO). 使 用 InsertTool 在 
某 个 特定 的 位 置 插 入 一 个 工具 按钮 . 也 可 以 使 用 AddCheckTool 和 AddRadioTool 来 避免 指定 
wxITEM_CHECK 或 wxITEM_RADIO 类 型 . AddSeparator 增加 一 个 分 割 线 ,基于 实现 的 不 同 ， 
它 可 能 显示 为 一 条 线 或 者 一 段 空白 . 使 用 InsertSeparator 在 某 个 特定 的 位 置 插入 一 个 分 割 线 , 例 
如 下 面 的 代码 将 增加 一 个 复 选 框 工具 按钮 ， 它 包含 一 个 标签 ("Save"), 一 个 图 片 ， 一 个 帮助 字 
符 串 ("Toggle button 1"): 


toolBar->AddTool(wxID_SAVE, wxT("Save"), bitmap, 
wxT("Toggle button 1"), wxITEM_CHECK); 


AddControl 增 加 一 个 控件 ， 比 如 combo 框 . InsertControl 在 某 个 位 置 插入 一 个 控件 ， 


DeleteTool 删 除 给 定 标识 符 的 工具 按钮 . DeleteToolByPos 删 除 指定 位 置 的 按钮 . RemoveTool 
移 除 给 定位 置 的 那个 按钮 但 是 并 不 释放 它 ， 而 是 将 它 的 指针 返回 给 . 


EnableTool 用 来 允许 或 者 禁止 某 个 工具 按钮 ,你 可 能 想 参 考 第 9 章 中 的 方法 ， 使 用 用 户 界 面 更 新 
事件 来 更 合理 的 作 这 个 动作 。 GetToolEnabled 画 数 返 回 某 个 工具 按钮 的 当前 可 用 状态 。 


FindByld 和 FindControl 来 通过 窗口 标识 符 寻 找 某 个 按钮 或 者 某 个 控件 。 


如 果 你 想 使 用 非 默认 大 小 16x15 的 图 标 。 你 可 以 使 用 SetToolBitmapSize 本 数 . 使 用 
GetToolBitmapSize 函 数 获得 当前 设置 的 图 片 尺寸 . GetToolSize 返 回 当前 工具 按钮 整个 的 大 


小 


o 


GetMargins 和 SetMargins 用 来 获取 和 设置 工具 条 的 左右 和 上 下 的 边界 。 


边 
GetToolClientData 和 SetToolClientData 通 过 窗口 标识 符 获取 和 设置 工具 按钮 绑 定 的 某 个 继承 
自 wxObject 的 类 . 


GetToolLongHelp 和 SetToolLongHelp 用 来 获取 或 者 设置 和 工具 按钮 绑 定 的 长 的 帮助 信息 。 这 
个 信息 可 以 被 显示 在 状态 条 或 者 别 的 什么 位 置 。GetToolShortHelp 则 用 来 获取 或 者 设置 工具 按 
钮 的 短 的 帮助 信息 。 


GetToolPacking 和 SetToolPacking 用 来 获取 和 设置 两 排 工 具 按 钮 之 间 的 间隔 。 如 果 是 垂直 工 
具 条 ， 则 为 水 平 工具 按钮 之 间 的 间 隅 ， 如 果 为 水 平 工 具 条 ， 则 为 垂直 工具 按钮 之 间 的 间隔 。 


GetToolPosition 返 回 某 个 由 窗口 标识 符 指定 的 工具 按钮 在 工具 条 上 的 位 置 。 
GetToolSeparation 和 SetToolSeparation 用 来 获取 或 者 设置 工具 条 上 分 割 线 的 大 小 。 
GetToolState 和 SetToolState 用 来 获取 或 者 设置 某 个 单 选 框 或 者 复 选 框 的 状态 。 
Realize 必 须 在 任何 按钮 被 增加 以 后 调用 。 

ToggleTool 反 选 某 个 单 选 或 者 复 选 按钮 的 状态 


wxStatusBar 


状态 条 是 一 个 狭长 的 窗口 ， 这 个 窗口 通常 被 放置 在 一 个 Frame 窗 口 的 底部 ， 用 来 提供 一 些 状态 
信息 。 状 态 条 可 以 包含 一 个 或 多 个 区 域 ， 区 域 可 以 拥有 固定 的 或 者 可 变 的 宽度 。 如 果 你 使 用 

wxFrame::CreateStatusBar 或 者 WxFrame::SetStatusBar 创 建 或 者 将 某 个 状态 条 和 frame 窗 口 

绑 定 ， 那 么 这 个 状态 条 的 大 小 ， 位 置 以 及 其 释放 都 由 这 个 frame 窗 口 负责 ， 并 且 这 个 状态 条 的 
大 小 也 不 包含 在 frame 窗口 的 客户 区 域内 ， 反 之 ， 任 何其 它 的 方式 创建 的 状态 条 ， 这 些 事情 都 
要 由 你 自己 的 代码 去 做 。 


下 面 是 创建 一 个 状态 条 的 例子 代码 ， 这 个 状态 条 有 三 个 区 域 ， 前 两 个 的 大 小 固定 是 60 象 素 ， 
第 三 个 将 使 用 剩余 的 区 域 : 


#include "wx/statusbr.h" 

wxStatusBar* statusBar = new wxStatusBar(frame, wxID_ANY, 
wxST_SIZEGRIP); 

frame->SetStatusBar(statusBar ); 

int widths[] = { 60, 60, -1 } 

statusBar ->SetFieldwidths(WXSIZEOF(widths), widths); 

statusBar ->SetStatusText(wxT("Ready"), 0); 


这 段 代 码 产生 的 结果 如 下 图 所 示 : 
Ready 


如 果 你 想 ， 你 其 至 可 以 在 状态 条 的 区 域 里 面 放置 一 些小 的 控件 。 这 需要 你 自己 管理 它们 的 尺 
寸 和 大 小 ， 例 如 在 你 继承 自 wxStatusBar 的 新 类 的 size 事 件 的 处 理 画 数 中 。 


wxStatusBar 的 窗口 类 型 ,注意 你 可 以 使 用 SetStatusStyles 函 数 设 置 某 个 区 域 的 类 型 
|:--- |:--- | |wxST_SIZEGRIP | 在 状态 条 的 右边 显示 一 个 小 的 修饰 . | 
wxStatusBar 的 事件 

没有 特别 的 事件 。 

wxStatusBar 的 成 员 函 数 

GetFieldRect 返 回 某 个 区 域 的 内 部 的 大 小 和 位 置 . 
GetFieldsCount 返 回 当 前 区 域 的 个 数 . SetFieldsCount 用 来 设置 区 域 的 个 数 。 
GetStatusText 返 回 当 前 某 个 区 域 的 文本 , SetStatusText 用 来 设置 某 个 区 域 的 文本 . 


PushStatusText 保 存 当 前 的 区 域 的 文本 到 一 个 堆栈 中 ， 并 且 把 参数 的 字符 串 显示 在 状态 条 上 . 
PopStatusText 则 将 堆栈 中 最 顶层 的 字符 串 显示 在 状态 条 上 。 


SetMinHeight 设 置 状 态 条 最 小 的 合理 高 度 。 


SetStatusWidths 采 用 一 个 整数 数组 来 设置 各 个 区 域 的 宽度 。 其 中 整数 代表 绝对 值 ， 而 负数 则 
代表 比例 ， 比 如 说 ， 如 果 你 希望 创建 一 个 有 三 个 区 域 的 状态 条 ， 其 中 最 右边 的 区 域 固定 为 100 
个 象 素 ， 左 边 的 两 个 区 域 按照 223 和 1/3 的 比例 瓜分 剩 下 的 区 域 ， 则 你 应 该 使 用 一 个 包含 -2,- 
1,100 三 个 整数 的 数组 作为 这 个 男 数 的 参数 。 


SetStatusStyles 使 用 区 域 个 数 和 一 组 整数 的 类 型 数组 来 给 各 个 区 域 设置 不 同 的 类 型 ， 这 些 整 
数 的 类 型 决定 了 区 域 的 外 观 。 其 中 wxSB_NORMAL 用 来 显示 标准 的 拥有 三 维 边界 的 下 沉 区 
域 ， 而 wxSB_FLAT 显 示 一 个 没有 边框 的 区 域 ， 而 wxSB_RAISED 则 显示 一 个 鼓 起 的 拥有 三 维 
边框 的 区 域 。 


第 四 章 小 结 


这 一 章 中 ， 我 们 介绍 了 足够 的 关于 各 种 窗口 类 和 控件 的 知识 ， 相 信 这 足以 是 你 可 以 开始 构建 
你 的 各 种 应 用 程序 。 如 果 你 还 希望 了 解 这 个 窗口 或 者 控件 的 更 多 的 知识 ， 请 参考 WxWidgets 的 
相关 手册 。 对 于 那些 更 深入 的 窗口 类 ， 以 及 怎样 创建 自己 的 控件 ， 我 们 将 在 第 12 章 介绍 。 阅 
读 wxWidgets 发 行 版 中 的 各 个 例子 也 将 是 非常 有 帮助 的 ， 比 如 samples/widgets， 
samples/toolbar, samples/text 和 samples/listbox 中 的 那些 例子 。 


在 接 下 来 的 一 章 里 ， 我 们 将 介绍 一 下 应 用 程序 怎样 在 不 同 的 表面 上 作画 ， 包 括 在 窗口 上 ， 
片上 或 者 是 打印 机 上 。 


第 五 章 绘画 和 打印 


这 一 章 里 ， 我 们 来 介绍 一 下 设备 上 下 文 ， 也 就 是 通常 所 说 的 在 一 个 窗口 或 者 一 个 打印 页 面 上 
画 的 概念 。 我 们 将 会 讨论 目前 拥有 的 设备 上 下 文 类 ， 以 及 wxWidgets 提 供 的 和 字体 ， 关 
4 线条 以 及 填充 等 相关 的 绘画 工具 集 。 接 下 来 我 们 会 描述 每 个 设备 上 下 文 的 绘 
wxWidgets 支 持 打 印 的 机 制 。 在 本 章 的 最 后 ， 我 们 会 简单 讨论 一 下 wxGLCanvas， 这 个 类 提供 

了 一 种 在 你 的 窗口 中 使 用 OpenGL 技 术 绘 制 三 维 图 形 的 方法 。 


5.1 理解 设 各 上 下 文 


在 wxWidgets 中 ， 所 有 的 绘画 相关 的 动作 ， 都 是 由 设备 上 下 文 完 成 的 。 每 一 个 设备 上 下 文 都 是 
wxDC 的 一 个 派生 类 。 从 来 就 没有 直接 在 窗口 上 绘画 这 种 事情 ， 每 次 在 窗口 上 绘画 ， 都 要 先 创 
建 一 个 窗口 绘画 设备 上 下 文 ， 然 后 在 这 个 上 下 文 上 绘画 。 其 它 一 些 设备 上 下 文 是 和 bitmap 图 

片 或 者 打印 机 绑 定 的 ， 你 也 可 以 设计 自己 的 设备 上 下 文 。 这 样 作 一 个 最 大 的 好 处 就 是 ， 你 的 

绘画 的 代码 是 可 以 共享 的 ， 如 果 你 的 代码 使 用 一 个 wxDC 类 型 的 参数 ， 顶 多 再 增加 一 个 用 于 缩 
放 的 分 辩 率 ， 那 么 这 段 代 码 就 可 以 被 同时 用 于 在 窗口 绘制 和 在 打印 机 上 绘制 。 让 我 们 先 来 描 
述 一 下 设备 上 下 文 的 主要 属性 。 


一 个 设备 上 下 文 拥 有 一 个 座 标 体系 ， 它 的 原点 通常 在 画布 的 左上 角 。 不 过 这 个 位 置 可 以 通过 
调用 SetDeviceOrigin 画 数 改 变 ， 这 样 的 效果 就 相当 于 对 随后 在 这 个 上 下 文 上 的 作 的 画 进 行 平 
移 。 这 种 使 用 方法 在 对 wxScrolledWindow 进 行 绘画 的 时 候 非常 常见 。 你 还 可 以 调用 
SetAxisOrientation 来 改变 坐标 系 的 放 向 ， 比 如 说 你 可 以 让 Y 轴 是 从 下 到 上 的 放 向 而 不 是 默认 
的 从 上 到 下 的 放 向 。 


逻辑 单位 和 设备 单位 是 有 区 别 的 。 设 各 单位 是 设备 本 地 的 单位 ， 对 于 计算 机 屏幕 来 说 ， 设 备 
单位 是 一 个 象 素 ， 而 对 于 一 个 打印 机 来 说 ， 设 各 单位 是 由 它 的 分 辩 率 决定 的 ， 这 个 分 辩 率 可 
以 用 GetSize (用 来 取得 设 各 单位 的 一 页 的 大 小 ) 或 者 GetSizeMM( 用 来 取得 以 毫米 为 单位 的 
一 页 的 大 小 ) 来 获得 。 


设备 上 下 文 的 映射 模式 定义 了 逮 辑 单位 到 设备 单位 的 转换 标准 。 要 注意 某 些 设备 上 下 文 ( 典 
型 的 例子 比如 : wxPostScriptDC) 只 支持 wxMM_TEXT 映 射 模式 。 下 表 列 出 了 目前 支持 的 映 
射 模式 : 


wxMM_TWIPS 每 个 逻辑 单位 为 1/20 点 , 或 者 1/1440 英 寸 . 
wxMM_POINTS 每 个 逻辑 单位 为 1 点 , 或 1172 英 寸 . 
wxMM_METRIC 每 个 逻辑 单位 为 1 毫米 . 

wxMM_LOMETRIC 每 个 逻辑 单位 为 1110 毫 米 . 

wxMM_TEXT 每 个 逻辑 单位 为 1 象 素 .这 是 默认 的 映射 模式 . 


你 可 以 通过 SetUserScale 画 数 给 逻辑 单位 指定 一 个 缩放 比例， 这 个 比例 乘 以 映射 模式 中 指定 
的 单位 ， 可 以 得 到 实际 逻辑 单位 和 设备 单位 之 间 的 关系 ， 上 比如 在 wxMM_TEXT 了 映射 模式 下 ， 
如 果 用 户 缩放 上 比例 为 (1.0,1.0)， 那 么 逻辑 单位 和 设备 单位 就 是 一 样 的 ， 这 也 是 设备 上 下 文中 映 
射 模式 和 用 户 缩放 比例 的 缺 省 值 。 

设备 上 下 文 还 可 以 通过 SetClippingRegion 函 数 指定 一 个 区 域 ， 这 个 区 域 以 外 的 部 分 将 不 被 显 
示 ， 可 以 使 用 DestroyClippingRegion 画 数 清除 设备 上 下 文 当前 指定 的 区 域 。 举 个 例子 ， 为 了 
将 一 个 字符 串 显 示 的 范围 限制 在 某 个 矩形 区 域 以 内 ， 你 可 以 先 指定 这 个 矩形 区 域 为 这 个 设备 


上 下 文 的 当前 区 域 ， 然 后 调用 函数 在 这 个 设备 上 下 文 上 绘制 这 个 字符 串 ， 即 使 这 个 字符 串 很 
长 ， 可 能 会 超出 这 个 矩形 区 域 ， 超 出 的 部 分 也 将 被 截 掉 不 被 显示 ， 然 后 再 调用 酌 数 清除 这 个 
区 域 就 可 以 了 。 


和 现实 世界 一 样 ， 为 了 绘画 ， 你 需要 先 选择 绘画 的 工具 ， 如 果 你 要 画 线 ， 那 么 你 需要 选择 画 
笔 ， 要 填充 一 个 区 域 ， 你 需要 选择 画 刷 ， 而 当前 字体 ， 文 本 前 景色 和 背景 色 等 ， 则 会 决定 你 
画布 上 的 文本 怎样 显示 。 晚 些 时 候 我 们 会 详细 讨论 这 些 。 我 们 先 来 看 看 目前 都 支持 那些 设备 
ERM: 


可 用 的 设备 上 下 文 
下 面 列 出 了 你 可 以 使 用 的 设备 上 下 文 : 


e wxClientDC. 用 来 在 一 个 窗口 的 客户 区 绘画 。 

。 wxBufferedDC. 用 来 代替 wxClientDC 来 进行 双 缓 冲 区 绘画 。 

e wxWindowDC. 用 来 在 窗口 的 客户 区 和 非 客 户 区 (比如 标题 栏 ) 绘画 .这 个 设备 上 下 文 极 
少 使 用 而 且 也 不 是 每 个 平台 都 支持 。 

wxPaintDC. 仅 用 在 重 绘 事件 的 处 理 画 数 中 ， 用 来 在 窗口 的 客户 区 绘画 。 

e wxBufferedPaintDC. 和 wxPaintDC 类 似 ， 不 过 采用 双 缓 冲 区 进行 绘画 。 

。 wxScreenDC. 用 来 直接 在 屏幕 上 绘画 。 

。 wxMemoryDC. 用 来 直接 在 图 片上 绘画 。 

wxMetafileDC. 用 来 创建 一 个 图 元 文件 (只 支持 Windows 和 Mac OS X). 

e wxPrinterDC. 用 来 在 打印 机 上 绘画 。 

e wxPostScriptDC. 用 来 在 PostScript 文 件 上 或 者 在 支持 PostScript 的 打印 机 上 绘画 。 


接 下 来 我 们 会 描述 一 下 怎样 来 创建 和 使 用 这 些 设备 上 下 文 。 打 印 机 设备 上 下 文 将 会 在 本 章 稍 
后 的 “使 用 打印 机 的 架构 ”小 节 中 进行 更 详细 的 讨论 。 


使 用 wxClientDC 在 窗口 客户 区 进行 绘画 


wxClientDC 用 来 在 非 重 绘 事件 处 理 函 数 中 对 窗口 的 客户 区 进行 绘制 。 例 如 ， 如 果 你 想 作 一 个 
信 手 涂鸦 的 程序 ， 你 可 以 在 你 的 铝 标 事件 处 理 函 数 中 创建 一 个 wxClientDC。 这 个 设备 上 下 文 
也 可 以 用 于 擦 除 背 景 事件 处 理 画 数 。 


下 面 的 例子 演示 了 怎样 使 用 鼠标 在 窗口 上 随便 乱 画 : 


BEGIN_EVENT_TABLE(MyWindow, wxWindow) 
EVT_MOTION(MyWindow: :OnMotion) 

END_EVENT_TABLE( ) 

void MyWindow: :OnMotion(wxMouseEvent& event) 


if (event.Dragging()) 


wxClientDC dc(this); 

wxPen pen(*wxRED, 1); // red pen of width 1 
dc.SetPen(pen); 
dc.DrawPoint(event.GetPosition()); 
dc.SetPen(wxNullPen) ; 


在 第 19 章 , “使 用 文档 和 视图 "中 ， 实 现 了 一 个 更 具有 可 用 性 的 涂鸦 工具 ， 它 使 用 线段 代替 了 

点 ， 并 且 实 现 了 重 做 和 撤消 的 操作 。 而 且 还 存储 了 所 有 的 线段 ， 以 便 在 windows 需 要 重 绘 的 时 
候 重 绘 所 有 的 线段 。 而 使 用 上 面 的 代码 ， 你 所 作 的 画 在 下 次 windows 重 绘 的 时 候 将 会 消失 。 当 
然 你 还 可 以 使 用 CaptureMouse 和 ReleaseMouse 函 数 ， 以 便 在 妃 标 按 下 的 时 候 ， 直 接 把 妃 标 
限制 在 你 的 绘画 窗口 的 客户 区 范围 内 。 


一 种 替代 wxClientDC 的 方法 是 使 用 wxBufferedDC， 后 者 将 你 的 所 有 绘画 的 结果 保存 在 内 存 
中 ， 然 后 当 自 己 被 释放 的 时 候 一 次 性 把 所 有 的 内 容 传 输 到 窗口 上 。 这 样 作 的 结果 是 使 得 整个 
绘画 过 程 更 平滑 ， 如 果 你 不 希望 用 户 看 到 绘画 的 结果 一 点 一 点 的 更 新 ， 你 可 以 使 用 这 种 方 

法 ， 使 用 wxBufferedDC 和 使 用 wxClientDC 的 代码 是 完全 一 样 的， 另外 为 了 提高 效率 ， 你 可 以 
在 wxBufferedDC 的 构造 画 数 中 传递 一 个 已 经 创建 好 的 bitmap 对 象 ， 以 避免 在 每 次 创建 
wxBufferedDC 的 时 候 创 建 一 个 新 的 图 片 。 


擦 除 窗口 背景 


窗口 类 通常 会 收 到 两 种 和 绘画 相关 的 事件 : wxPaintEvent 事 件 用 来 绘制 窗口 客户 区 的 主要 图 
形 ， 而 wxEraseEvent 事 件 则 用 来 通知 应 用 程序 擦 除 背 景 。 如 果 你 只 拦截 并 处 理 了 
wxPaintEvent 事 件 ， 则 默认 的 wxEraseEvent 事 件 处 理 画 数 会 用 最 近 一 次 的 
wxWindow::SetBackgroundColour 函 数 调 用 设置 的 颜色 或 者 别 的 合适 的 颜色 清除 整个 背景 。 


这 也 许 看 上 去 有 些 混乱 ， 但 是 这 种 把 背景 和 前 景 分 开 的 方法 可 以 更 好 的 支持 那些 使 用 这 种 架 
构 的 平台 (比如 windows) 上 的 控件 。 举 个 例子 ， 如 果 你 希望 在 一 个 窗口 上 使 用 某 种 纹路 的 背 
景 ， 如 果 你 在 OnPaint 函 数 中 是 平 铺 纹理 贴图 ， 你 可 能 会 看 到 一 些 闪 烁 ， 因 为 在 绘画 之 前 ， 系 
统 进行 了 清除 背景 的 动作 ， 在 这 种 背景 和 前 景 分 离 的 架构 下 ， 你 可 以 拦截 wxEraseEvent 事 


件 ， 然 后 在 其 处 理 函 数 中 什么 事情 都 不 做 ， 或 者 你 干脆 在 擦 除 背 景 事件 处 理 范 数 中 平 铺 你 的 
BRA, MERA SAHRA PAAR 当然， 这样 也 会 带 来 一 些 双 绥 冲 绘画 方 


面 的 问题 ， 我 们 接 下 来 会 谈 到 ) . 


在 某 些 平台 上 。 仅 仅 是 拦截 wxEraseEvent 事 件 仍 然 不 足以 阻止 所 有 的 系统 默认 的 重 绘 动作 ， 
让 你 的 窗口 的 背景 不 只 是 一 个 纯色 背景 的 最 安全 的 方法 是 调用 
wxWindow::SetBackgroundStyle 然 后 传递 WxBG_STYLE_CUSTOM 参 数 。 这 将 告诉 
wxWidgets 把 所 有 背景 重 绘 的 动作 留 给 应用 程序 自己 处 理 。 


如 果 你 真 的 决定 实现 自己 的 背景 擦 除 事件 久 理 函数 ， 你 可 以 先 调用 wxEraseEvent::GetDC 来 
尝试 返回 一 个 已 经 创建 的 设备 上 下 文 ， 如 果 返 回 的 值 为 空 ， 再 创建 一 个 wxClientDC 设 各 上 下 
文 。 这 将 允许 wxWidgets 不 在 擦 除 背 景 事件 中 国定 创建 一 个 设备 上 下 文 ， 象 前 面 例子 中 提 到 的 
那样 ， 擦 除 背 景 事件 处 理 函 数 中 可 能 根本 不 会 用 到 设 各 上 下 文 ， 因 此 在 事件 中 创建 一 个 设 各 
上 下 文 可 能 是 不 必要 的 。 下 面 的 代码 演示 了 怎样 在 擦 除 背 景 事件 使 用 平 铺 图 片 的 方法 绘制 窗 
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BEGIN_EVENT_TABLE(MyWindow, wxWindow) 
EVT_ERASE_BACKGROUND(MyWindow: :OnErase) 

END_EVENT_TABLE( ) 

void MyWindow: :OnErase(wxEraseEvent& event) 


wxClientDC* clientDC = NULL; 
if (!event.GetDC()) 
clientDC = new wxClientDC(this); 
wxDC* dc = clientDC ? clientDC : event.GetDC() ; 
wxSize sz = GetClientSize(); 
wxEffects effects; 
effects.TileBitmap(wxRect(0, ©, sz.x, Sz.y), *dc, m_bitmap); 
if (clientDC) 
delete clientDC; 


和 重 绘 窗口 事件 一 样 ，wxEraseEvent::GetDC 返 回 的 设 各 上 下 文 已 经 设置 了 区 域 ， 使 得 只 有 
需要 重 绘 的 部 分 才 会 被 重 绘 。 


使 用 wxPaintDC 在 窗口 上 绘画 


如 果 你 定义 了 一 个 窗口 重 画 事件 处 理 函 数 ， 则 必须 在 这 个 义理 函数 中 产生 一 个 wxPaintDC 设 
备 上 下 文 (即使 你 根本 不 使 用 它 ) ， 并 且 使 用 它 来 进行 你 需要 的 绘画 动作 。 产 生 这 个 对 象 将 
告诉 wxWidgets 的 窗口 体系 这 个 窗口 的 需要 重 画 的 区 域 已 经 被 重男 了 ， 这 样 窗口 系统 就 不 会 重 
复 的 发 送 重 画 消 息 给 这 个 窗口 了 。 在 重 画 事件 中 ， 你 还 可 以 调用 
wxWindow::GetUpdateRegion 画 数 来 获得 需要 重 画 的 区 域 ， 或 者 使 用 wxWindow:: ISExposed 
函数 来 判断 某 个 点 或 者 某 个 矩形 区 域 是 否 需要 重 画 ， 然 后 优化 代码 使 得 仅 在 这 个 范围 内 的 内 
AREH, 虽然 在 重 画 事件 中 创建 的 wxPaintDC 设 备 上 下 文 会 自动 将 自己 限制 在 需要 重 画 的 
区 域内 ， 不 过 你 自己 知道 需要 重 画 的 区 域 的 话 ， 可 以 对 代码 进行 相应 的 优化 。 


重 画 事件 是 由 于 用 户 和 窗口 系统 的 交互 造成 的 ， 但 是 它 也 可 以 通过 调用 wxWindow::Refresh 和 
wxWindow:: RefreshRect 函 数 手 动产 生 。 如 果 你 准确 的 知道 窗口 的 哪个 部 分 需要 重 画 ， 你 可 
以 指定 只 重 画 那 一 部 分 区 域 以 便 尽 可 能 的 减少 闪烁 。 这 样 作 的 一 个 问题 是 ， 并 不 能 保证 窗口 
在 调用 Refresh 画 数 以 后 会 马上 重 画 。 如 果 你 真 的 需要 立刻 调用 你 的 重男 事件 处 理 函 数 ， 比 如 
说 你 在 进行 一 个 很 耗 时 的 计算 ， 需 要 即时 显示 一 些 进 度 ， 你 可 以 在 调用 Refresh 或 者 
RefreshRectlA a 49 AwxWindow:: Updater žit. 
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否 位 于 需要 更 新 的 区 域 范围 内 以 便 决定 是 否 需要 重 画 。 


BEGIN_EVENT_TABLE(MyWindow, wxWindow) 
EVT_PAINT(MyWindow: :OnPaint ) 

END_EVENT_TABLE( ) 

void MyWindow: :OnPaint(wxPaintEvent& event) 


wxPaintDC dc(this); 

dc.SetPen( *wxBLACK_PEN); 

dc.SetBrush(*wxRED_BRUSH) ; 

// 获取 窗口 大 小 

wxSize sz = GetClientSize(); 

// 要 绘制 的 矩形 的 大 小 

wxCoord w = 100, h = 50; 

// FSA REER OIE, 

// 但 是 不 为 负数 的 位 置 

int x = wxMax(@, (SZ.xw)/2); 

int y = wxMax(@, (sz.yh)/2); 

wxRect rectToDraw(x, y, w, h); 

// 只 有 在 需要 的 时 候 才 重 画 以 便 提高 效率 

if (IsExposed(rectToDraw) ) 
DrawRectangle(rectToDraw); 


注意 在 默认 情况 下 ， 当 窗口 大 小 改变 时 ， 只 有 那些 需要 重 画 的 地 方才 会 被 更 新 ， 指 定 
wxFULL_REPAINT_ON_RESIZE 窗 口 类 型 可 以 覆盖 这 种 默认 情况 以 使 得 整个 窗口 都 被 刷新 。 
在 我 们 上 面 的 例子 中 ， 就 需要 指定 这 种 情况 ， 因 为 我 们 矩形 的 位 置 是 根据 窗口 大 小 计算 出 来 
的 ， 如 果 窗 口 变 大 而 我 们 只 更 新 需要 更 新 的 部 位 ， 则 可 能 在 原来 的 窗口 中 留 下 半 个 矩形 或 者 
在 屏幕 上 出 现 两 个 矩形 ， 这 和 我 们 的 初 囊 是 不 一 致 的 。 


wxBufferedPaintDC 是 wxPaintDC 的 双 缓 冲 区 版 本 。 只 需要 简单 的 将 重 绘 事件 义理 函数 中 的 
wxPaintDC 换 成 wxBufferedPaintDC 就 可 以 了 ， 它 会 首先 将 所 有 的 图 片 画 在 一 个 内 存 位 图 上 ， 
然后 在 自己 被 释放 的 时 候 一 次 性 将 其 画 在 窗口 上 以 减 小 闪烁 。 


正 象 我 们 前 面 提 到 的 那样 ， 另 外 一 个 减少 闪烁 的 方法 ， 是 把 背景 和 前 景 统一 在 窗口 重 画 事件 
处 理 画 数 中 ， 而 不 是 将 它们 分 开 人 处理， 配合 wxBufferedPaintDC， 那 么 所 有 的 绘画 动作 在 完 
成 之 前 都 是 在 内 存 中 进行 的 ， 这 样 在 窗口 被 重 绘 之 前 你 将 看 不 到 窗口 背景 被 更 新 。 你 需要 增 
加 一 个 空 的 背景 擦 除 事件 义理 函数 ， 并 且 使 用 SetBackgroundStyle 画 数 设置 背景 类 型 为 
wxBG_STYLE_CUSTOM 以 便 告诉 某 些 系统 不 要 自动 擦 除 背 景 。 在 wxScrolledWindow 中 你 还 
有 注意 需要 对 绘画 设备 上 下 文 的 原点 进行 平移 ， 并 据 此 重新 计算 你 自己 的 图 片 位 置 。 ( 译 者 
注 : 在 wxScrolledWindow 窗 口中 的 wxPaintDC 的 原点 是 当前 窗口 滚动 位 置 下 的 原点 ， 这 通常 
不 是 我 们 所 需要 的 ， 因 为 我 们 绘画 通常 要 基于 整个 滚动 窗口 本 身 的 原点 ， 调 用 PrepareDC 画 
数 可 以 将 其 设置 成 滚动 窗口 本 身 的 原点 ， 在 绘画 的 时 候 可 以 通过 CalcUnscrolledPosition 本 数 
将 当前 客户 区 中 的 某 个 点 转换 成 相对 于 整个 滚动 窗口 区 的 座 标 ， 如 下 面 的 代码 演示 的 那样 ) 
下 面 的 代码 演示 了 怎样 在 一 个 继承 自 wxScrolledWindow 的 窗口 类 中 进行 绘画 并 且 尽 可 能 的 避 
免 出 现 闪 烁 。 


#include "wx/dcbuffer.h" 

BEGIN_EVENT_TABLE(MyCustomCtrl, wxScrolledwWindow) 
EVT_PAINT(MyCustomCtr1l: :OnPaint ) 
EVT_ERASE_BACKGROUND(MyCustomCtr1: :OnEraseBackground ) 

END_EVENT_TABLE( ) 

// BBS ERA 

void MyCustomCtr1: :OnPaint(wxPaintEvent& event) 


{ 
wxBufferedPaintDC dc(this); 
// 平移 设备 座 标 以 便 我 们 不 需要 关心 当前 滚动 窗口 的 位 置 
PrepareDC(dc); 
// 在 重 画 绘制 函数 中 绘制 背景 
PaintBackground(dc); 
// 然后 绘制 前 景 


} 

/// 绘制 背景 

void MyCustomCtrl: :PaintBackground(wxDC& dc) 
{ 


wxColour backgroundColour = GetBackgroundColour(); 
if (!backgroundColour .Ok()) 
backgroundColour = 
wxSystemSettings: :GetColour (wxSYS_COLOUR_3DFACE) ; 
dc.SetBrush(wxBrush(backgroundColour ) ); 
dc.SetPen(wxPen(backgroundColour, 1)); 
wxRect windowRect(wxPoint(0, ©), GetClientSize()); 
// Bile EB SAIS P RNR RRA TE: a BOM he SION Bis 
// 因 为 在 前 面 我 们 已 经 对 设备 上 下 文 进行 了 PrepareDC 的 动作 。 
CalcUnscrolledPosition(windowRect.x, windowRect.y, 
& windowRect.x, & windowRect.y); 
dc.DrawRectangle(windowRect ) ; 


} 
// ZEB 只 为 了 防止 内 烁 
void MyCustomCtr1: :OnEraseBackground(wxEraseEvent& event) 


{ 
} 


为 了 提高 性 能 ， 当 你 使 用 wxBufferedPaintDC 时 ， 你 可 以 维护 一 个 足够 大 的 〈 比 如 屏幕 大 小 
的 ) 位 图 ， 然 后 将 其 传递 给 wxBufferedPaintDC 的 构造 画 数 作为 第 二 个 参数 ， 这 可 是 避免 每 
次 使 用 wxBufferedPaintDC 的 时 候 创建 和 释放 一 个 位 图 。 


wxBufferedPaintDC 通 常会 从 其 缓冲 区 中 拷贝 整个 客户 区 (用 户 可 见 部 分 ) 大 小 ， 在 滚动 窗口 
中 ， 其 内 部 创建 的 设备 上 下 文 并 不 会 随 着 PrepareDC 的 调用 平移 其 座 标 系 。 不 过 你 可 以 通过 
在 wxBufferedPaintDC 的 构造 画 数 中 指定 wxBUFFER_VIRTUAL _AREA (默认 为 
wxBUFFER_CLIENT_AREA) 参数 来 避免 这 一 问题 。 不 过 这 种 情况 下 ， 你 需要 提供 一 个 和 整 
个 滚动 窗口 的 虚拟 大 小 一 样 的 缓冲 区 ， 而 这 通常 效率 是 很 低 的 ， 应 该 尽量 避免 。 另 外 一 个 需 
要 注意 的 是 对 于 设置 为 wxBUFFER_CLIENT_AREA 的 wxBufferedPaintDC 到 目前 为 止 还 不 支 
持 缩 放 (SetUserScale) 。 


你 可 以 在 随 书 光盘 的 examples/chap12/thumbnail 例 子 的 wxThumbnailCtrl 控 件 中 ， 找 到 使 用 
wxBufferedPaintDC 的 完整 的 例子 。 


使 用 wxMemoryDC 在 位 图 上 绘 


内 存 设备 上 下 文 是 和 一 个 位 图 绑 定 的 设备 上 下 文 ， 在 这 个 设备 上下文 上 的 所 有 绘画 都 将 画 在 
那个 位 图 上 上面。 使 用 的 方法 是 先 使 用 默认 的 构造 男 数 创建 一 个 内 存 设备 上 下 文 ， 然 后 使 用 
SelectObject 函 数 将 其 和 一 个 位 图 绑 定 ， 在 完成 所 有 的 绘画 以 后 再 调用 SelectObject 函 数 参 数 


为 wxNullBitmap 来 移 除 绑 定 的 位 图 ， 代 码 如 下 所 示 : 


wxBitmap CreateRedOutlineBitmap() 


wxMemoryDC memDC; 

wxBitmap bitmap(200, 200); 
memDC.SelectObject(bitmap) ; 
memDC.SetBackground( *wxwWHITE_BRUSH) ; 
memDC.Clear(); 

memDC.SetPen( *wxRED_PEN); 

memDC.SetBrush( *wxTRANSPARENT_BRUSH) ; 
memDC.DrawRectangle(wxRect(10, 10, 100, 100)); 
memDC.SelectObject (wxNullBitmap) ; 

return bitmap; 


te Fy LAS FA Bites A ik SE FIC HAR TR n ag EFE, EAR 
后 的 地 方 我 们 会 对 此 进行 介绍 。 


使 用 wxMetafileDC 创 建 图 元 文件 


wxMetafileDC 适 用 于 Windows 和 Mac OS X， 它 在 这 两 个 平台 上 分 别提 供 了 绘制 Windows 图 元 
文件 和 Mac PICT 的 画布 。 人 允许 在 wxMetafile 对 象 上 绘画 ， 这 个 对 象 保 留 了 一 组 绘画 动作 记 
录 ， 可 以 被 其 它 应 用 程序 使 用 或 者 通过 wxMetafile:: Play 画 数 闻 其 绘制 在 别 的 设备 上 下 文 上 。 


使 用 wxScreenDC 访 问 屏幕 


使 用 wxScreenDC 可 以 在 整个 屏幕 的 任何 位 置 绘 画 。 通 常 这 在 给 拖 放 操作 提供 可 见 响应 的 时 候 
比较 有 用 〈 比 如 拖 放 分 割 窗口 的 分 割 条 的 时 候 ) 。 久 于 性 能 方面 的 考虑 。 你 可 以 将 其 操作 的 
屏幕 区 域 限 制 在 一 个 矩形 区 域 (通常 是 程序 窗口 所 在 的 区 域 ) 内 。 当 然 ， 除 了 在 屏幕 上 绘 
画 ， 我 们 还 可 以 把 绘画 从 屏幕 上 拷贝 到 其 它 设 各 上 下 文中 ， 以 便 实现 屏幕 捕获 。 因 为 无 法 限 
制 别 的 应 用 程序 的 行为 ， 所 以 wxScreenDC 类 通常 在 当前 应 用 程序 的 窗口 内 工作 的 最 好 。 


下 面 是 将 屏幕 捕获 到 位 图 文件 的 例子 : 


wxBitmap GetScreenShot() 


wxSize screenSize = wxGetDisplaySize(); 

wxBitmap bitmap(screenSize.x, screenSize.y); 

wxScreenDC dc; 

wxMemoryDC memDC; 

memDC.SelectObject(bitmap) ; 

memDC.Blit(0, ©, screenSize.x, screenSize.y, & dc, ©, 0); 
memDC.SelectObject (wxNullBitmap) ; 

return bitmap; 


使 用 wxPrinterDC 和 wxPostScriptDC 实 现 打印 


wxPrinterDC 用 来 实现 打印 机 接口 。 在 windows 和 Mac 平 台 上 ， 这 个 接口 实现 到 标准 打印 接口 
的 映射 。 在 其 它 类 Unix 系 统 上 ， 没 有 标准 的 打印 接口 ， 因 此 需要 使 用 wxPostScriptDC 代 蔡 
(除非 打开 了 Gnome 打 印 支持 ， 参 考 接 下 来 的 小 节 , “在 类 Unix 系 统 上 使 用 GTK+ 进 行 打 
ED”) o 


可 以 通过 多 种 途径 创建 wxPrinterDC 对 象 ， 你 还 可 以 传递 设置 了 纸张 类 型 ， 横 向 或 者 纵向 ， 打 
印 份 数 等 参数 的 wxPrintData 对 象 给 它 。 一 个 简单 的 创建 wxPrinterDC 设 备 上 下 文 的 方法 是 显 
示 一 个 wxPrintDialog 对 话 框 ， 在 用 户 选择 各 种 参数 以 后 ， 使 用 wxPrintDialog::GetPrintDC 的 方 
法 获取 一 个 对 应 的 wxPrinterDC 对 象 。 作 为 更 高 级 的 用 法 ， 你 可 以 从 wxPrintout 定 义 一 个 自己 
的 派生 类 ， 以 便 更 精确 定义 打印 以 及 打印 预览 的 行为 ， 然 后 把 它 的 一 个 实例 传递 给 wxPrinter 
对 象 〈 在 后 面 小 节 中 还 会 详细 介绍 ) 。 


如 果 你 要 打印 的 内 容 主要 是 文本 ， 你 可 以 考虑 使 用 wxHtmlEasyPrinting 类 ， 以 便 忽 略 
wxPrinterDC 和 wxPrintout 排 版 的 细节 : 你 只 需要 按照 wxWidgets' 实 现 的 那些 HTML 的 语法 编 
写 HTML 文 件 ， 然 后 创建 一 个 wxHtmlEasyPrinting 对 象 用 来 实现 打印 和 预览 ， 这 通常 可 以 节省 
你 几 天 到 几 周 的 时 候 来 对 那些 文本 ， 表 格 和 图 片 进 行 排版 。 详 情 请 参考 第 12 章 ,“ 高 级 窗口 


wxPostScriptDC 用 来 打印 到 PostScript 文 件 。 虽然 这 种 方式 主要 应 用 在 类 Unix 系 统 上 ， 不 过 在 
别 的 系统 上 你 一 样 可 以 使 用 它 。 用 这 种 方式 打印 需要 先 产 生 PostScript 文 件 ， 而 且 还 要 保证 你 
拥有 一 个 支持 打印 PostScript 文 件 的 打印 机 。 


你 可 以 通过 传递 WxPrintData 参 数 ， 或 者 传递 一 个 文件 名 ， 一 个 bool 值 以 确定 是 否 显示 一 个 打 
印 设置 对 话 框 和 一 个 父 窗口 来 创建 一 个 wxPostScriptDC， 如 下 所 示 : 
#include "wx/dcps.h" 


wxPostScriptDC dc(wxT("output.ps"), true, wxGetApp().GetTopwindow()); 
if (dc.0k()) 


{ 
// 告诉 它 在 哪里 找到 AFM 字体 文件 。 
dc.GetPrintData().SetFontMetricPath(wxGetApp().GetFontPath()); 
// 设置 分 辩 率 (每 英寸 多 少 个 点 ， 默 认 720) 
dc.SetResolution(1440); 
// 开始 绘画 

} 


wxPostScriptDC 的 一 个 特殊 的 地 方 在 于 你 不 能 直接 使 用 GetTextExtent 来 获取 文本 大 小 的 信 
息 。 你 必须 先 用 wxPrintData::SetFontMetricPath 指 定 AFM (Adobe Font Metric) 文件 的 路 
径 ， 就 象 上 面 例子 中 的 那样 。 你 可 以 从 下 面 的 路 笃 下 载 GhostScript AFM 文件 。 


ftp://biolpc22.york.ac.uk/pub/support/gs_afm.tar.gz 


5.2 绘画 工具 


在 wxWidgets 中 ， 绘 画 操 作 就 象 是 一 个 技术 非常 高 超 的 艺术 家 ， 快 速 的 选择 颜色 ， 绘 画工 具 ， 
然后 画 场景 的 一 小 部 分 ， 然 后 换 不 同 的 颜色 ， 不 同 的 工具 ， 再 绘画 场景 的 其 它 部 分 ， 周 而 反 
复 的 操作 。 因 此 ， 接 下 来 我 们 来 介绍 一 下 wxColour,wxPen, wxBrush, wxFont 和 wxPalette 这 些 
绘画 工具 。 还 有 其 它 的 一 些 内 容 也 是 有 帮助 的 ， 比 如 wxRect，wxRegion，wxPoint 和 
wxSize， 我 们 会 在 第 13 章 ， 例 数据 结构 类 命中 对 它们 进行 介绍 。 


注意 这 些 类 使 用 了 例 引 用 记 数 傅 的 方法 ， 使 用 内 部 指针 以 避免 大 块 的 内 存 拷 贝 ， 在 大 多 数 情 
况 下 ， 你 可 以 直接 以 局 部 变量 的 方式 定义 颜色 ， 男 笔 ， 画 刷 和 字体 对 象 而 不 用 担心 性 能 。 如 
果 你 的 程序 确实 因此 而 拥有 性 能 上 的 问题 ， 你 才 需 要 考虑 采取 一 些 方法 来 提高 性 能 ， 比 如 将 
其 中 的 一 些 局 部 变量 改变 成 类 的 成 员 。 


wxColour 


你 可 以 使 用 wxColour 类 来 定义 各 种 各 桩 的 颜色 。 〈 因 为 wxWidgets 开 始 于 爱丁堡 ， 它 的 API 使 
用 英 式 拼写 ， 不 过 对 于 那些 对 拼写 很 敏感 的 人 ，wxWidgets 还 是 给 wxColor 定 义 了 一 个 别名 
wxColour) 。 


你 可 以 使 用 SetTextForeground 和 SetTextBackground 画 数 来 定义 一 个 设 各 上 下 文中 文本 的 颜 
色 ， 也 可 以 使 用 wxColour 来 创建 画笔 和 刷子 。 


wxColour 对 象 有 很 多 种 创建 方法 ， 你 可 以 使 用 RGB 三 元 色 的 值 (0 到 255) 来 构建 wxColour， 
或 者 通过 一 个 标准 的 字符 串 ， 比 如 WHITE 或 者 CYAN， 或 者 从 另外 一 个 wxColour 对 象 创 建 。 
或 者 你 还 可 以 直接 使 用 系统 预定 的 颜色 对 象 指针 : wxBLACK, wxWHITE, wxRED, wxBLUE, 
wxGREEN, wxCYAN, 和 wxLIGHT_GREY 还 有 一 个 wxNullColour 对 象 用 来 代表 未 初始 化 的 颜 
色 ， 它 的 Ok 画 数 总 是 返回 False。 


使 用 wxSystemSettings 类 可 以 获取 很 多 系统 默认 的 颜色 ， 上 比如 3D 表 面 颜色 ， 上 默认 的 窗口 背景 
颜色 ， 菜 单 文 本 颜色 等 等 。 请 参考 相关 文档 中 wxSystemsSettings::GetColour 的 部 分 来 获取 详 
细 的 列表 。 


下 面 的 例子 演示 了 创建 wxColour 的 方法 : 


wxColour color(0, 255, ©); // green 

wxColour color(wxT("RED")); // red 

// 使 用 面板 的 三 维 表面 系统 颜色 

wxColour color(wxSystemSettings: :GetColour(wxSYS_COLOUR_3DFACE) ); 


wxTheColourDatabase 指 针 用 来 在 系统 之 类 的 颜色 和 颜色 名 之 间 建 立 映 射 ， 通 过 颜色 名 寻找 
对 应 的 颜色 对 象 或 者 通过 颜色 对 象 来 寻找 对 应 的 颜色 名 ， 如 下 所 示 : 


wxTheColourDatabase->Add(wxT("PINKISH"), wxColour(234, 184, 184)); 
wxString name = wxTheColourDatabase->FindName( 

wxColour(234, 184, 184)); 
wxString color = wxTheColourDatabase->Find(name); 


下 面 列 出 了 目前 支持 的 标准 颜色 : aquamarine, black, blue, blue violet, brown, cadet blue, 
coral, cornflower blue, cyan, dark gray, dark green, dark olive green, dark orchid, dark slate 
blue, dark slate gray dark turquoise, dim gray, firebrick, forest green, gold, goldenrod, gray, 
green, green yellow, indian red, khaki, light blue, light gray, light steel blue, lime green, 
magenta, maroon, medium aquamarine, medium blue, medium forest green, medium 
goldenrod, medium orchid, medium sea green, medium slate blue, medium spring green, 
medium turquoise, medium violet red, midnight blue, navy, orange, orange red, orchid, pale 
green, pink, plum, purple, red, salmon, sea green, sienna, sky blue, slate blue, spring green, 
steel blue, tan, thistle, turquoise, violet, violet red, wheat, white, yellow, 和 yellow green. 


wxPen 


你 可 以 使 用 SetPen 函 数 指定 一 个 设备 上 下 文 使 用 的 画笔 (wxPen) 。 画 笔 指 定 了 随后 的 绘画 
操作 中 线条 的 颜色 ， 粗 细 以 及 线条 类 型 。wxPen 的 开销 很 小 ， 你 可 以 放心 的 在 你 的 绘图 代码 
中 创建 局 部 变量 类 型 的 画笔 对 象 而 不 用 对 它们 进行 全 局 存储 。 


下 表 列 出 了 目前 支持 的 画笔 线条 类 型 ， 其 中 Hatch 和 stipple 类 型 目前 的 GTK+ 版 本 不 支持 : 


线形 示例 描述 


wxSOLID — ABR. 
wxTRANSPARENT 透明 颜色 . 

wxDOT 2 纯 点 线 . 
wxLONG_DASH — 一 一 长 虚线 . 


短 虚线 .在 windows 平 台 上 等 同 于 


wxSHORT_DASH td | ONG SASH. 
wxDOT_DASH 一 -一 -一 - 短线 和 点 间隔 线 . 

使 用 一 个 位 图 代替 点 的 点 虚线 ,这 个 位 
WS TIEPLE CX 图 是 其 构造 图 数 的 第 一 个 参数 
wxUSER_DASH 一 -一 -一 -一 一 自 定义 虚线 . 参考 用 户 手册 . 


wxBDIAGONAL_HATCH ea RARER. 
wxCROSSDIAG_HATCH xx MMMM MMM 交叉 虚线 . 
wxFDIAGONAL_HATCH SSSSSSSSSS 斜 线 虚线 . 


wxCROSS_HATCH 二 + 十 + 十 + 十 二 + ”十字 虚线 . 
wxHORIZONTAL_HATCH - 水 平 线段 虚线 . 
wxVERTICAL_HATCH 11111111111 ”垂直 线段 虚线 . 


使 用 SetCap 定 义 粗 线条 的 末端 的 样子 : wxCAP_ROUND 是 默认 的 设置 ， 只 是 粗 线条 的 末端 应 
该 使 用 圆 形 ，wxCAP_PROJECTING 则 只 是 使 用 方形 并 且 有 一 个 凸 起 ，wxCAP_BUTT 则 只 是 
直接 使 用 方形 。 


使 用 SetJoin 函 数 来 设置 当 有 线段 相连 时 候 的 联结 方式 ， 默 认 的 值 是 wxJOIN_ROUND， 这 种 
情况 下 转角 是 圆 形 的 ， 其 它 可 选 的 值 还 有 wxJOIN_BEVEL 和 wxJOIN_MITER. 


你 也 可 以 直接 使 用 预定 的 画笔 对 象 : wxRED_PEN, wxCYAN_PEN, wxGREEN_PEN, 
wxBLACK_PEN, wxWHITE_PEN, wxtrANSPARENT_PEN, wxBLACK_DASHED_PEN, 
wxGREY_PEN, wxMEDIUM_GREY_PEN 和 wxLIGHT_GREY_PEN. 这 些 都 是 指针 ， 所 以 在 
SetPen 函 数 中 使 用 的 时 候 ， 频 该 使 用 ”号 指向 它们 的 实例 。 还 有 一 个 预定 义 的 对 象 (Kes 
$+) wxNullPen， 可 以 用 来 复位 设 各 上 下 文中 的 画笔 


下 面 是 创建 画笔 的 一 些 演示 代码 ,都 用 来 产生 一 个 纯 红色 的 画笔 : 


wxPen pen(wxColour(255, ©, ©), 1, wxSOLID); 
wxPen pen(wxT("RED"), 1, wxSOLID); 

wxPen pen = (*wxRED_PEN); 

wxPen pen(*wxRED_PEN); 


上 面 例子 中 的 最 后 两 行使 用 了 引用 记 数 的 方法 ， 实 际 上 内 部 指向 同一 个 对 象 。 这 种 引用 记 数 
的 方法 在 绘画 对 象 中 很 常用 ， 它 使 得 对 象 赋值 和 拷贝 的 系统 开销 非常 小 ， 不 过 同时 它 意味 着 
一 个 对 象 的 改变 将 会 影响 到 其 它 所 有 使 用 同一 个 引用 的 对 象 。 


一 个 既 可 以 简化 画笔 对 象 的 创建 和 释放 过 程 ， 又 不 需要 将 画笔 对 象 存 储 在 自己 的 对 象 中 的 方 
法 ， 是 使 用 全 局 指针 wxThePenList 来 创建 和 存储 所 有 你 需要 的 画笔 对 象 ， 如 下 所 示 : 


wxPen* pen = wxThePenList->FindOrCreatePen(*wxRED, 1, wxSOLID); 


这 个 wxThePenList 指 向 的 对 象 业 负责 存储 所 有 的 画笔 对 象 并 且 在 应 用 程序 退出 的 时 候 自 动 释 
放 所 有 的 画笔 。 很 显然 ， 你 应 该 小 心 不 要 过 量 使 用 这 个 对 象 以 免 画 笔 对 象 占用 大 量 的 系统 内 
存 ， 而 且 也 要 注意 前 面 我 们 提 到 过 的 使 用 引用 对 象 的 问题 ， 你 可 以 使 用 RemovePen 画 数 从 
wxThePenList 中 删除 一 个 画笔 但 是 却 不 释放 它 所 占 的 内 存 。 


wxBrush 


设备 上 下 文 当前 使 用 的 画 刷 对 象 可 以 用 SetBrush 画 数 指定 ， 它 决定 设备 上 下 文中 图 像 的 填充 
方式 。 你 也 可 以 使 用 它 来 定义 设备 上 下 文 的 默认 背景 ， 这 样 的 定义 方式 可 以 使 得 背景 不 只 是 
简单 的 纯色 。 和 画笔 对 象 一 样 ， 画 刷 对 象 的 系统 消耗 也 非常 小 ， 你 可 以 直接 使 用 局 部 变量 的 
方式 定义 它 。 


画 刷 的 构造 画 数 采用 一 个 颜色 参数 和 一 个 画 刷 类 型 参数 ， 如 下 表 所 示 : 





画 刷 类 型 例子 苗 述 

wxSOLID =a 纯色 画 刷 . 

wxTRANSPARENT 透明 画 刷 . 

wxBDIAGONAL_HATCH WHA 反 斜 线 画 刷 
wxCROSSDIAG_HATCH Ce 交叉 画 刷 . 

wxFDIAGONAL_HATCH Rss 斜 线 画 刷 

wxCROSS_HATCH HHH 十 字画 刷 . 
wxHORIZONTAL_HATCH E— 水 平 线 画 刷 . 

wxVERTICAL_HATCH LIII 垂直 线 画 刷 . 

wxSTIPPLE kxd 位 图 画 刷 , Rae ye RABE. 


你 也 可 以 直接 使 用 下 面 这 些 系统 预定 义 的 画 刷 : wxBLUE_BRUSH, wxGREEN_BRUSH, 
wxWHITE BRUSH, wxBLACK_BRUSH, wxGREY_BRUSH, wxMEDIUM_GREY_BRUSH, 
wxLIGHT_GREY_BRUSH, wxtrANSPARENT_BRUSH, wxCYAN_BRUSH 和 
wxRED_BRUSH. 这 些 都 是 指针 ， 类 似 的 还 有 wxNullBrush 用 来 复位 设备 上 下 文 的 画 刷 。 


下 面 是 创建 红色 纯色 画 刷 的 例子 : 


wxBrush brush(wxColour(255, ©, ©), wxSOLID); 

wxBrush brush(wxT("RED"), wxSOLID); 

wxBrush brush = (*wxRED_BRUSH); // a cheap operation 
wxBrush brush(*wxRED_BRUSH); 


和 画笔 一 样 ， 画 刷 也 有 一 个 用 来 保存 列表 的 全 局 指针 指针 : wxTheBrushList, (RAR FH 
这 样 使 用 它 : 


wxBrush* brush = wxTheBrushList->FindOrCreateBrush(*wxBLUE, wXSOLID); 


同样 要 避免 在 应 用 程序 过 量 使 用 以 及 要 注意 引用 记 数 使 用 的 问题 。 使 用 RemoveBrush 来 从 
wxTheBrushList 中 移 除 一 个 画 刷 而 不 释放 其 内 存 。 


wxFont 
你 可 以 使 用 字体 对 象 来 设置 一 个 设备 上 下 文 使 用 的 字体 ， 字 体 对 象 有 下 面 一 些 属性 : 
字体 大 小 用 来 以 点 (1/72 英 寸 ) 为 单位 指定 字体 中 的 最 大 高 度 。wxWidgets 会 选择 系统 中 最 接 
近 的 字体 。 
字体 家 族 用 来 指定 一 个 家 族 系 列 ， 象 下 表 中 描述 的 那 祥 ， 指 定 一 个 字体 家 族 而 不 指定 一 个 字 
体 的 名 字 是 为 了 移植 的 方便 ， 因 为 你 不 大 可 能 要 求 某 个 字体 的 名 字 存 在 于 所 有 的 平台 。 

字体 家 族 标 识 符 例子 描述 
非 印刷 字体 ， 依 平台 的 不 同 


wxFONTFAMILY_SWISS ABCDEFGabcdefg12345 通常 是 Helvetica 或 Arial. 
wxFONTFAMILY_ROMAN ABCDEFGabcdefg12345 ”一 种 正规 的 印刷 字体 . 
wxFONTFAMILY_SCRIPT ABCBEFHabeddfg 12545 ”一 种 艺术 字体 . 
wxFONTFAMILY_MODERN ABCDEFGabcdefg12345 ”一 种 等 宽 字体 .通常 是 Courier 


WxFONTFAMILY DECORATIVE aCmejfGabetal2s45 ”一 种 装饰 字体 . 


wxWidgets 选 择 一 


wxFONTFAMILY_DEFAULT 个 默认 的 字体 家 族 
mY 4 ` = 


字体 类 型 可 以 是 wxNORMAL, wxSLANT 或 wxITALIC。 其 中 wxSLANT 可 能 不 是 所 有 的 平台 或 
者 所 有 的 字体 都 支持 。 

weight 属 性 的 值 则 可 以 是 wxNORMAL, wxLIGHT 或 wxBOLD. 

下 划 线 可 以 被 设置 或 者 关闭 。 


字体 名 属性 是 可 选 参数 ， 用 来 指定 一 个 特定 的 字体 ， 如 果 其 为 空 ， 则 将 使 用 指定 字体 家 族 默 
认 的 字体 。 


可 选 的 编码 方式 参数 用 来 指定 字体 编码 和 程序 用 设备 上 下 文 绘画 的 文本 的 编码 方式 的 映射 ， 
详情 请 参考 第 16 章 ， 例 编写 国际 化 应 用 程序 命 。 


你 可 以 使 用 默认 的 构造 画 数 创建 一 个 字体 ， 或 者 使 用 上 表 中 列 出 的 字体 家 族 创建 一 个 字体 。 


也 可 以 使 用 下 面 这 些 系统 预定 义 的 字体 : wxNORMAL _FONT, wxSMALL_FONT, 
wxITALIC_FONT 和 wxSWISS_FONT 除了 wxSMALL_FONT 以 外 ， 其 它 的 字体 都 使 用 同 祥 大 
小 的 系统 默认 字体 (wxSYS_DEFAULT_GUI FONT), 而 wxSMALL_FONT 则 比 另 外 的 三 个 字体 


要 使 用 字体 ， 你 需要 在 进行 任何 字体 相关 的 操作 (比如 DrawText 和 GetTextExtent) 之 前 ， 使 
用 wxDC::SetFont 函 数 设 置 字 体 。 


下 面 的 代码 演示 了 怎样 构造 一 个 字体 对 象 : 


wxFont font(12, wxFONTFAMILY_ROMAN, wxITALIC, wxBOLD, false); 

wxFont font(10, wxFONTFAMILY_SWISS, wxNORMAL, wxBOLD, true, 
wxT("Arial"), wxFONTENCODING_ISO8859_1)); 

wxFont font(wxSystemSettings: :GetFont (wxSYS_DEFAULT_GUI_FONT)); 


和 画笔 和 画 刷 一 样 ， 字 体 也 有 一 个 全 局 列表 指针 wxTheFontList， 用 来 查找 以 前 创建 的 字体 或 
者 创建 一 个 新 的 字体 : 


wxFont* font = wxTheFontList->FindOrCreateFont(12, wxSWISS, 
wxNORMAL, wxXNORMAL); 


同样 的 ， 避 免 大 量 使 用 这 个 全 局 指针 ， 因 为 其 分 配 的 内 存 要 到 程序 退出 的 时 候 才 会 释放 。 你 
可 以 使 用 RemoveFont 从 中 移 除 一 个 字体 但 是 不 释放 相关 的 内 存 。 


在 本 章 晚 些 时 候 我 们 会 看 到 一 些 使 用 文本 和 字体 的 例子 。 同 时 你 也 可 以 看 一 下 字体 例子 程 
序 ， 它 人 允许 你 选择 一 个 字体 然后 看 看 某 些 文本 是 什么 样子 ， 也 可 以 让 你 更 改 字体 的 大 小 和 别 
的 属性 。 


«= Font wxWidgets demo 
File Font Select 


Paste text here to see how it looks 
in the given font 


Font size is 10 points, family: wxSWISS, encoding: Unknown encoding [-1} 
Style: wxNORMAL, weight’ wxNORMAL, fixed width: no 
Native font info: Arial 10 








Bit 
EEE 








Welcome to wxWidgets font demo! 
wxPalette 


调 色 板 是 一 个 表 ， 这 个 表 的 大 小 通常 是 256, 表 中 的 每 一 个 索引 被 映射 到 一 个 对 应 的 rgb 颜色 

值 。 通 常 在 不 同 的 应 用 程序 需要 在 同一 个 显示 设备 上 共享 确定 数目 的 颜色 的 时 候 使 用 。 通 过 
设置 一 个 调 色 板 ， 应 用 程序 之 间 的 颜色 可 以 取得 一 个 平衡 。 调 色 板 也 被 用 来 把 一 个 低 颜 色 深 
度 的 图 片 映 射 到 当前 可 用 的 颜色 ， 因 此 每 个 wxBitmap 都 有 一 个 可 选 的 调 色 板 。 


因为 现在 大 多 数 电 脑 的 显示 设备 都 支持 真 彩色 ， 调 色 板 已 经 很 少 使 用 了 。 应 用 程序 定义 的 
RGB 颜色 可 以 直接 被 显示 设备 映射 到 最 接近 的 颜色 。 


创建 一 个 调 色 板 需要 提供 一 个 调 色 板 大 小 参数 和 三 个 分 别 代表 红 绿 蓝 三 种 颜色 的 数组 。 你 可 
以 通过 GetColoursCount 函 数 得 到 当前 调 色 板 中 条 目的 数量 。GetRGB 辑 数 通 过 索引 找到 其 代 
蔡 的 颜色 的 RGB 值 ， 而 GetPixel 则 通过 RGB 值 得 到 其 相应 的 索引 。 


使 用 wxDC::SetPalette 函 数 给 某 个 设 各 上 下 文 指定 一 个 调 色 板 。 上 比如 ， 你 可 以 给 当前 的 设备 上 
下 文 指 定 一 个 位 于 某 个 低产 色 深 度 的 wxBitmap 对 象 中 的 调 色 板 ， 一 边 让 设备 上 下 文 知道 怎样 
把 这 个 图 片 中 的 索引 颜色 映射 到 真实 的 RGB 颜 色 。 当 在 一 个 指定 了 调 色 板 的 设备 上 下 文中 使 
用 wxColour 绘 画 的 时 候 ， 系 统 会 自动 在 设备 上 下 文 的 调 色 板 中 查找 最 匹配 的 颜色 的 索引 ， 
此 你 点 该 指定 一 个 和 你 要 用 的 颜色 最 接近 的 调 色 板 。 


wxPalette 的 另外 一 个 用 法 是 用 来 查询 一 个 低 颜 色 深 度 图 像 文 件 〈 比 如 GIF) 中 的 图 像 的 不 同 
的 颜色 。 如 果 这 个 图 像 拥 有 一 个 调 色 板 ， 即 时 这 个 图 片 已 经 被 转换 成 RGB 格式 ， 区 分 图 像 中 
的 不 同 颜色 也 仍然 是 个 很 容易 的 事 。 类 似 的 ， 通 过 调 色 板 ， 你 也 可 以 把 一 个 真 彩 色 的 图 片 转 
换 成 低 颜色 深度 的 图 片 ， 下 面 的 代码 演示 了 怎样 将 一 个 真 彩色 的 PNG 文 件 转 换 成 8bit 的 
windows 位 图 文件 : 


// 加 载 这 个 PNG 文 件 

wxImage image(wxT("image.png"), wxBITMAP_TYPE_PNG) ) 
// 创建 一 个 调 色 板 

unsigned char* red = new unsigned char[256]; 
unsigned char* green = new unsigned char[256]; 
unsigned char* blue = new unsigned char[256]; 

for (size_t i = 0; i &lt; 256; i ++) 


red[i] = green[i] = blue[i] = 
wxPalette palette(256, red, green, blue); 


// 设置 调 色 板 和 颜色 深度 
image.SetPalette(palette); 


image .SetOption(wxIMAGE_OPTION_BMP_FORMAT, wxBMP_8BPP_PALETTE) ; 


// 存储 文件 
image.SaveFile(wxT("image.bmp"), wxBITMAP_TYPE_BMP); 


降低 颜色 深度 的 更 实用 的 方法 请 参考 第 10 章 ， 售 在 程序 
小 节 ， 介 绍 怎样 用 wxQuantize 类 来 作 这 件 事 。 


wxWidgets 定 义 了 一 个 空 的 调 色 板 对 象 wxNullPalette. 


( 译 者 注 : 这 一 小 节 翻 译 的 太 费 劲 了 ) 


序 中 使 用 图 片 依 中 的 例 降 低 颜 色 深 度 例 


5.3 设备 上 下 文中 的 绘 围 国 数 


在 这 一 小 节 里 ， 我 们 来 近 距 离 的 了 解 一 下 怎样 在 设备 上 下 文中 绘画 。 下 表 列 出 了 设备 上 下 文 
类 主要 的 成 员 函 数 ， 在 接 下 来 的 小 节 里 ， 我 们 会 举例 介绍 其 中 的 大 部 分 函数 ， 你 也 可 以 从 
wxWidgets 的 手册 中 获取 它们 的 详细 信息 。 


Blit 


Clear 
SetClippingRegion 
DestroyClippingRegion 
GetClippingBox 
DrawArc DrawEllipticArc 


DrawBitmap Drawlcon 


DrawCircle 


DrawEllipse 
DrawLine DrawLines 


DrawPoint 


DrawPolygon 
DrawPolyPolygon 


DrawRectangle 
DrawRoundedRectangle 


DrawText 
DrawRotatedText 


DrawSpline 


FloodFill 


Ok 


把 某 个 设备 上 下 文 的 一 部 分 拷贝 到 另外 一 个 设备 上 下 文 上 . 你 
可 以 指定 的 参数 包括 拷贝 多 大 ， 拷 贝 到 什么 位 置 ,拷贝 的 逻辑 
函数 以 及 如 果 源 设备 上 下 文 是 内 存 设备 上 下 文 的 时 候 ， 是 不 
是 使 用 透明 遮 罩 等 。 


使 用 当前 的 背景 刷 刷新 背景 . 


用 来 设置 和 释放 设备 上 下 文 使 用 的 区 域 。 区 域 是 用 来 将 设备 
上 下 文中 所 有 的 绘画 操作 限制 在 某 个 范围 内 的 ， 它 可 以 是 一 
个 矩形 ， 也 可 以 是 由 wxRegion 指 定 的 复杂 区 域 ， 使 用 

GetClippingBox 本 数 来 取得 包含 当前 区 域 的 一 个 矩形 范围 。 


使 用 当前 的 画笔 和 夯 刷 画 一 段 圆 弧 或 者 椭圆 弧 线 . 


在 指定 位 置 面 一 副 图 片 或 者 是 一 个 图 标 .如 果 是 图 片 可 以 指定 
一 个 透明 遮 量 . 


使 用 当前 的 画笔 和 画 刷 画 一 个 圆 形 . 

使 用 当前 的 画笔 和 画 刷 画 一 个 顶 圆 形 . 

使 用 当前 的 画笔 画 一 条 线 或 者 多 条 线 。 最 后 的 那个 点 是 不 被 
显示 的 。 

使 用 当前 设置 的 画笔 画 一 个 点 . 

DrawPolygon 函 数 通 过 指定 一 个 点 的 数组 或 者 指向 点 结构 的 


指针 的 列表 来 绘制 一 个 封闭 的 多 边 形 ， 还 可 以 指定 一 个 可 选 
的 座 标 平移 。wxWidgets 会 自动 封闭 第 一 个 点 和 最 后 一 个 
点 ， 所 以 你 不 必 在 最 开始 和 最 末端 指定 同一 个 点 。 
DrawPolyPolygon 辑 数 则 同时 绘制 多 个 多 边 形 ， 在 某 些 平台 
上 这 上 比 多 次 调用 DrawPolygon 函 数 更 有 效率 。 

使 用 当前 的 画笔 和 画 刷 绘制 一 个 矩形 或 者 圆 角 和 矩形 

使 用 当前 字体 ， 文 本 前 景色 和 文本 背景 色 在 指定 的 位 置 绘制 
一 段 文 本 或 者 一 段 旋转 的 文本 。 


使 用 当前 的 画笔 在 指定 的 控制 点 下 使 用 云 行规 画 一 条 平滑 曲 
线 . 


以 Flood 填 充 的 方式 使 用 当前 的 画 刷 对 指定 起 始点 的 范围 进行 
填充 (比如 : 封闭 相 邻 同 颜色 区 域 中 的 颜色 将 被 蔡 换 ) . 


如 果 设 各 已 经 准备 好 可 以 开始 绘画 则 返回 true. 
用 来 设置 或 者 获取 背景 画 刷 设置 。 这 些 设置 将 在 Clear 函 数 或 


SetBackground 
GetBackground 


SetBackgroundMode 
GetBackgroundMode 


SetBrush GetBrush 
SetPen GetPen 
SetFont GetFont 
SetPalette GetPalette 


SetTextForeground 
GetTextForeground 
SetTextBackground 
GetTextBackground 


SetLogicalFunction 
GetLogicalFunction 


GetPixel 
GetTextExtent 
GetPartialTextExtents 
GetSize GetSizeMM 


StartDoc EndDoc 


StartPage EndPage 


Device ToLogicalX 
Device ToLogicalXRel 
Device ToLogicalY 
Device ToLogicalY Rel 


LogicalToDevicexX 
LogicalToDeviceXRel 
LogicalToDeviceY 
LogicalToDeviceY Rel 


SetMapMode 
GetMapMode 


SetAxisOrientation 


SetDeviceOrigin 
GetDeviceOrigin 


SetUserScale 
GetUserScale 


A 一 些 设置 了 复 厅 的 绘画 逻辑 参数 的 函数 中 被 使 用 。 上 加 
设置 为 wxtrANSPARENT_BRUSH。 


用 来 设置 绘制 文本 时 候 的 背景 类 型 ， 取 值 为 wxSOLID 或 者 
wxTRANSPARENT。 通 常 你 希望 设置 为 后 者 ， 以 便 保留 绘 
制 文本 区 域 已 经 存在 的 背景 。 


用 来 设置 当前 画 刷 ， 默 认 值 未 定义 。 
用 来 设置 当前 画笔 ， 默 认 值 未 定义 。 


用 来 设置 当前 字体 ， 黑 认 值 未 定义 。 
用 来 设置 当前 调 色 板 。 


用 来 设置 文本 的 前 景 颜色 和 背景 颜色 ， 默 认 值 前 景 为 黑色 青 
景 为 白色 。 


逻辑 葬 数 用 来 设置 画笔 或 者 画 刷 或 者 (EBA) 设备 上 
下 文 自己 的 象 素 的 显示 和 传输 方式 。 默 认 值 WxXCOPY 表 示 直 
接 显示 或 者 拷贝 当前 颜色 。 


返回 某 个 点 的 颜色 . 和 
没有 实现 这 个 功能 


返回 给 定 文本 的 大 小 。 


返回 以 设 各 单位 或 者 毫米 指定 的 长 宽 。 


这 两 个 函数 只 在 打印 设备 上 下 文中 使 用 ， 前 者 显示 一 条 消息 
表明 正在 打印 ， 后 者 则 隐藏 这 个 消息 。 


在 打印 设备 上 下 文中 开始 和 结束 一 页 。 


将 设备 座 标 转换 成 逻辑 座 标 ， 可 以 是 绝对 值 也 可 以 是 相对 
值 。 


将 逻辑 座 标 转换 成 设备 座 标 。 


象 前 面 描述 过 的 那样 ，MapMode 用 来 (和 SetUserScale 一 
起 ) 指定 逻辑 单位 到 设备 单位 的 映射 。 


用 来 指定 X 轴 和 Y 轴 的 方向 。 默 认 X 轴 为 从 左 到 右 (True) , 
Y 轴 为 从 上 到 下 (False) 。 


置 座 标 原点 ， 可 以 用 来 实现 平移 。 


设置 缩放 值 。 该 值 用 于 逻辑 单位 到 设备 单位 的 转换 。 


绘制 文本 


设备 上 下 文 绘制 文本 的 方式 取决 于 以 下 几 个 参数 : 当前 字体 ， 字 体 背 景 模式 ， 文 本 背景 色 和 
文本 前 景色 。 如 果 背 景 模式 是 wxSOLID， 文 本 背后 的 部 分 将 会 以 当前 的 文本 背景 色 擦 除 ， 如 
果 是 wxTRANSPARENT， 则 文本 的 背景 将 保留 原先 的 背景 。 


传递 给 DrawText 的 参数 是 一 个 字符 串 和 一 个 点 (或 者 两 个 整数 ) 。 其 中 点 (或 者 两 个 整数 ) 
指定 的 位 置 将 会 是 文本 最 左上 角 的 位 置 。 下 面 是 一 个 例子 : 


void DrawTextString(wxDC& dc, const wxString& text, 
const wxPoint& pt) 
{ 


wxFont font(12, wxFONTFAMILY_SWISS, wxNORMAL, wxBOLD); 
dc.SetFont( font); 

dc.SetBackgroundMode(wxTRANSPARENT ) ; 
dc.SetTextForeground( *wxBLACK) ; 

dc.SetTextBackground( *wxWHITE); 

dc.DrawText(text, pt); 


你 也 可 以 使 用 DrawRotatedText 函 数 来 绘制 一 段 旋转 的 文本 ， 其 中 角度 的 值 由 函数 的 最 后 一 个 
参数 指定 ， 下 面 的 代码 演示 了 一 段 以 45 度 角 增 加 的 文本 : 


wxFont font(20, wxFONTFAMILY_SWISS, wxNORMAL, wxNORMAL ); 

dc.SetFont( font); 

dc.SetTextForeground(wxBLACk) ; 

dc.SetBackgroundMode (wxTRANSPARENT ) ; 

for (int angle = 0; angle &lt; 360; angle += 45) 
dc.DrawRotatedText(wxT("Rotated text..."), 300, 300, angle); 


运行 结果 如 下 图 所 示 : 


RS 
xa} paleJo HP g> 
S tated text... 
S 
42 
N 


a 
tated text... 


1*91 Pee} 


在 Windows 平 台 上 ， 只 有 TrueType 类 型 的 字体 才 可 以 实现 旋转 输出 ， 要 注意 
wxNORMAL_FONT 指 定 的 字体 并 不 是 TrueType 字 体 。 


通常 情况 下 ， 你 需要 知道 当前 正 要 绘制 的 文本 将 占用 设备 上 下 文中 多 大 的 地 方 ， 你 可 以 通过 
GetTextExtent 函 数 来 作 到 这 一 点 ， 它 的 原型 如 下 : 


void GetTextExtent(const wxString& string, 
wxCoord* width, wxCoord* height, 
wxCoord* descent = NULL, wxCoord* externalLeading = NULL, 
wxFont* font = NULL); 


这 个 图 数 的 原型 中 可 以 看 出 ， 后 面 的 三 个 参数 是 可 选 的 ， 其 中 descent 参 数 和 
externalLeading 参 数 ( 译 者 注 : 在 汉字 里 面 用 处 不 大 ) WALE: 英文 字符 的 基线 通常 不 是 
字符 的 最 底 端 ，descent 用 来 获取 某 个 字符 的 最 底 端 到 基线 的 距离 ， e we 
获取 descent 到 下 一 行 顶端 的 距离 。 最 后 一 个 参数 font 可 以 用 来 指定 以 这 个 字体 为 基准 (而 不 
是 设备 上 下 文 自 己 的 字体 ) 来 获取 测量 值 。 


下 面 的 代码 把 一 段 文 本 在 窗口 的 中 间 位 置 显示 


void CenterText(const wxString& text, wxDC& dc, wxWindow* win) 
{ 
dc.SetFont(*wxNORMAL_FONT); 
dc.SetBackgroundMode(wxTRANSPARENT ) ; 
dc.SetTextForeground( *wxRED) ; 
// 获取 窗口 大 小 和 文本 大 小 
wxSize sz = win->GetClientSize(); 
wxCoord w, h; 
dc.GetTextExtent(text, & w, & h); 
// 计算 为 了 居中 显示 需要 的 文本 开始 位 置 
// 并 保证 其 不 为 负数 ， 
int x = wxMax(@, (sz.x - w)/2); 
int y = wxMax(@, (sz.y - h)/2); 
dc.DrawText(msg, x, Yy); 


如 果 你 需要 知道 每 个 字符 的 精确 占用 大 小 ， 你 可 以 使 用 GetPartialTextExtents 函 数 ， 它 使 用 
wxString 和 一 个 wxArraylnt 的 引用 作为 参数 。 这 个 函数 的 效率 在 某 些 平台 上 优 于 对 每 个 单个 的 
字符 使 用 GetTextExtent 函 数 。 

绘制 线段 和 形状 


这 里 用 到 的 函数 原型 包括 那些 用 来 画 点 ， 画 线 ， 和 矩形 ， 圆 形 以 及 椭圆 等 的 函数 。 它 们 都 使 用 
当前 的 画笔 设置 和 画 刷 设置 ， 画 笔 用 来 决定 轮 廊 线 的 颜色 和 模式 ， 画 刷 用 来 决定 填充 的 颜色 
和 方式 : 


下 面 演 示 了 一 段 代 码 和 这 段 代 码 产生 的 图 形 : 


void D 


{ 
// 


dc. 
dc. 


// 


dc. 


// 


dc. 


// 


de. 
dc. 


// 


dc. 


// 


dc. 


// 


dc. 
dc. 
de. 


// 


dc. 
dc. 


// 


dc. 


// 


dc. 


// 
dc. 


rawSimpleShapes(wxDC& dc) 


设置 黑色 的 轮廓 线 ， 绿 色 的 填充 色 
SetPen(wxPen(*wxBLACK, 2, wxSOLID)); 
SetBrush(wxBrush(*wxGREEN, wxSOLID)); 
画 点 

DrawPoint(5, 5); 

E 

DrawLine(10, 10, 100, 100); 


EH 
SetBrush(wxBrush(*wxBLACK, wxCROSS_HATCH) ) ) ; 
DrawRectangle(50, 50, 150, 100); 


改 成 红色 画 刷 
SetBrush(*wxRED_BRUSH); 


画 圆 角 矩 形 
DrawRoundedRectangle(150, 20, 100, 50, 10); 


没有 轮廓 线 的 圆 角 矩形 

SetPen( *wxTRANSPARENT_PEN); 
SetBrush(wxBrush(*wxBLuE) ); 
DrawRoundedRectangle(250, 80, 100, 50, 10); 


改变 颜色 
SetPen(wxPen(*wxBLACK, 2, wxSOLID)); 
SetBrush(*wxBLACK) ; 


i 
DrawCircle(100, 150, 60); 


再 次 改变 画 刷 颜色 
SetBrush(*wxWHITE) ; 


画 一 个 椭圆 
DrawEllipse(wxRect(120, 120, 150, 50)); 





注意 一 个 约定 俗 成 的 规矩 ， 线 上 的 最 后 一 个 点 将 不 会 绘制 。 


要 绘制 一 段 国 弧 ， 需 要 使 用 DrawArc 画 数 ， 提 供 一 个 起 点 ， 一 个 终点 和 一 个 圆心 的 位 置 。 


弧 将 以 逆 时 针 方 向 从 起 点 画 至 终点 ， 举 例如 下 : 


int x 
dc .Dra 


= 10, y = 200, radius = 20; 
wArc(xradius, y, x + radius, y, x, y); 


段 


~ 


绘制 椭圆 弧 的 函数 DrawEllipticArc 采 用 一 个 容纳 这 个 椭圆 的 矩形 的 四 个 顶点 ， 以 及 椭圆 员 开 始 
和 结束 的 角度 作为 参数 ， 如 果 开 始 和 结束 的 角度 相同 ， 则 将 绘制 一 个 完整 的 椭圆 。 


// 绘制 一 个 包含 在 顶点 为 (10，100 ) ， 
// 大 小 为 200x40\. AMAEM 270 到 420 度 的 圆 弧 . 
dc.DrawEllipticArc(10, 100, 200, 40, 270, 420); 


如 果 你 需要 快速 绘制 很 多 条 线段 ， 那 么 DrawLines 将 会 比 多 次 调用 DrawLine 拥 有 更 高 的 效 
率 ， 下 面 的 例子 演示 了 快速 绘制 10 个 点 之 间 的 线段 ， 并 且 指 定 了 一 个 (100,100) 的 偏 移 量 : 


wxPoint points[10]; 
for (size_t i = 0; i &lt; 10; i++) 
{ 

pt.x = i*10; pt.y = i*20; 


int offsetX = 100; 
int offsetY = 100; 
dc.DrawLines(10, points, offsetX, offsety); 


DrawLines 不 会 填充 线段 环绕 的 区 域 。 如 果 你 想 在 画 线 的 同时 填充 其 环绕 区 域 ， 你 需要 使 用 
DrawPolygon 豆 数 ， 它 的 参数 包括 点 的 个 数 ， 点 的 列表 ， 可 选 的 平移 参数 以 及 填充 类 型 。 填 
充 类 型 默认 为 WxXODDEVEN_RULE， 也 可 以 使 用 wxWINDING_RULE。 而 
DrawPolygonPolygon 用 来 同时 绘制 多 个 Polygon， 它 的 额外 的 一 个 参数 是 另外 一 个 整数 的 数 
组 ， 用 来 指定 在 前 面 的 点 的 数组 中 每 个 Polygon 中 点 的 个 数 。 


下 面 代码 演示 了 怎样 使 用 这 两 个 萎 数 绘制 polygons : 


void DrawPolygons(wxDC& dc) 


{ 
wxBrush brushHatch(*wxRED, wxFDIAGONAL_HATCH); 
dc.SetBrush(brushHatch) ; 
wxPoint star[5]; 
star[0] = wxPoint(100, 60); 
star[1] = wxPoint(60, 150); 
star[2] = wxPoint(160, 100); 
star[3] = wxPoint(40, 100); 
star[4] = wxPoint(140, 150); 
dc.DrawPolygon(WXSIZEOF(star), star, 0, 30); 
dc.DrawPolygon(WXSIZEOF(star), star, 160, 30, wxWINDING_RULE); 
wxPoint star2[10]; 
star2[0] = wxPoint(0, 100); 
star2[1] = wxPoint(-59, -81); 
star2[2] = wxPoint(95, 31); 
star2[3] = wxPoint(-95, 31); 
star2[4] = wxPoint(59, -81); 
star2[5] = wxPoint(0, 80); 
star2[6] = wxPoint(-47, -64); 
star2[7] = wxPoint(76, 24); 
star2[8] = wxPoint(-76, 24); 
star2[9] = wxPoint(47, -64); 
int count[2] = {5, 5}; 
dc.DrawPolyPolygon(WXSIZEOF(count), count, star2, 450, 150); 
} 
结果 如 下 图 所 示 : 


使 用 云 行规 画 平滑 曲线 


DrawSpline 画 数 让 你 可 以 绘制 一 个 称 为 急 云 行规 象 的 平滑 曲线 .这 个 画 数 有 三 个 点 和 多 个 点 两 
个 形式 ， 下 面 的 代码 对 两 者 都 进行 了 演示 : 


// 三 点 云 行规 曲线 

dc.DrawSpline(10, 100, 200, 200, 50, 230); 
// 五 点 云 行 规 曲线 

wxPoint star[5]; 


star[0] = wxPoint(100, 60); 
star[1] = wxPoint(60, 150); 
star[2] = wxPoint(160, 100); 
star[3] = wxPoint(40, 100); 


star[4] = wxPoint(140, 150); 
dc.DrawSpline(WXSIZEOF(star), star); 


结果 如 下 图 所 示 : 


绘制 位 图 


在 设备 上 下 文 上 绘制 位 图 有 两 种 主要 的 方法 : DrawBitmap 和 Blit。DrawBitmap 其 实 是 Blit 的 一 
种 简写 形式 ， 它 使 用 一 个 位 图 ， 一 个 位 置 和 一 个 bool 类 型 的 透明 标志 参数 。 根 据 图 像 的 制作 和 
读 取 过 程 的 不 同 ， 位 图 的 透明 绘制 可 以 通过 指定 一 个 透明 庶 章 或 者 一 个 Alpha 通 道 (通常 用 来 
实现 半 透 明 ) 来 实现 ， 下 面 的 代码 演示 了 在 一 段 文 本 上 显示 的 半 透 明 的 图 片 : 


wxString msg = wxT("Some text will appear mixed in the image's shadow..."); 
int y = 75; 

for (size_t i = 0; i &lt; 10; i++) 

{ 


y += dc.GetCharHeight() + 5; 
dc.DrawText(msg, 200, y); 


} 
wxBitmap bmp(wxT("toucan.png"), wxBITMAP_TYPE_PNG); 
dc.DrawBitmap(bmp, 250, 100, true); 


运行 结果 如 下 图 所 示 : 文本 在 图 片 下 面 以 半 透 明 的 方式 隐隐 浮现 。 


Some text will appear mixed in the image's shadow... 


Some text will appea image's shadow 
Some text will appe image's shadow 
Some text fans in the image's shadow 
Some text 4 ie e's shadow 
Some text valine s shadow 
Some text 人 e image's shadow 





Some text will appear mixed inthe image's shadow... 


Some text will appear mixed in the image's shadow... 
Some text will appear mixed in the image's shadow... 


Blit 芳 数 就 略微 显 的 复杂 些 ， 它 允许 你 拷贝 一 个 设备 上 下 文 的 一 部 分 到 另外 一 个 设备 上 下 文 ， 
下 面 是 这 个 汞 数 的 原型 : 





bool Blit(wxCoord destX, wxCoord destyY, 
wxCoord width, wxCoord height, wxDC* dcSource, 
wxCoord srcX, wxCoord srcy, 
int logicalFunc = wxCOPY, 
bool useMask = false, 
wxCoord srcMaskX = -1, wxCoord srcMaskY = -1); 


这 个 画 数 将 dcSource 参 数 指定 的 设备 上 下 文中 开始 于 srcX，srcY 的 位 置 ， 大 小 为 width， 
height 的 区 域 拷贝 到 目标 设备 上 下 文 (KHAAA) 的 destX，destY 的 位 置 ， 并 且 使 用 指 
定 的 逮 辑 函数 进行 拷贝 。 默 认 的 逮 辑 函数 是 wxCOPY， 意 味 着 直接 把 源 中 的 象 素 原 封 不 动 的 


传输 到 目标 去 。 其 它 的 逻辑 男 数 依照 平台 的 不 同 有 所 不 同 ， 不 是 所 有 的 逻辑 函数 都 支持 所 有 
的 平台 。 我 们 将 在 本 节 稍 后 对 逮 辑 函数 进行 专门 介绍 。 


nag gi aun ao ce EE UseMask 参 数 指定 是 否 使 用 透明 
遮 材 ， 而 srcMaskX 和 srcMaskY 则 可 以 通过 其 设置 不 采用 和 主 位 图 一 致 的 遮 罩 位 置 。 


下 面 的 代码 演示 了 怎样 读 取 一 个 位 图 并 将 其 平 铺 在 另外 一 个 更 大 的 设备 上 下 文 上 ,并 且 保 留 图 
片 本 身 的 透明 属性 : 


wxMemoryDC dcDest; 
wxMemoryDC dcSource; 
int destWidth = 200, destHeight = 200; 
// 创建 目标 位 图 
wxBitmap bitmapDest(destWidth, destHeight); 
// 加 载 调 色 板 位 图 
wxBitmap bitmapSource(wxT("pattern.png"), wxBITMAP_TYPE_PNG); 
int sourceWidth = bitmapSource.GetWidth(); 
int sourceHeight = bitmapSource.GetHeight(); 
// 用 白色 清除 目标 背景 
dcDest.SelectObject(bitmapDest); 
dcDest .SetBackground( *wxWHITE_BRUSH) ; 
dcDest.Clear(); 
dcSource.SelectObject(bitmapSource); 
// 将 小 的 位 图 平 铺 到 大 的 位 图 
for (int i = 0; i &lt; destWidth; i += sourceWidth) 
for (int j = 0; j &lt; destHeight; j += sourceHeight) 


dcDest.Blit(i, j, sourceWidth, sourceHeight, 
& dcSource, ©, ©, wxCOPY, true); 


} 
// 释 放 内 存 设备 上 下 文 的 位 图 部 分 


dcDest.SelectBitmap(wxNullBitmap); 
dcSource.SelectBitmap(wxNullBitmap); 


你 可 以 使 用 Drawlcon 本 数 直接 在 设备 上 下 文 的 某 个 位 置 显示 图 标 ， 图 标 将 总 以 透明 方式 显 
示 : 


#include "file.xpm" 
wxIcon icon(file_xpm); 
dc.DrawIcon(icon, 20, 30); 


填充 特定 区 域 


ee 一 个 起 始点 参数 ， 一 个 颜色 参数 用 来 确定 
充 的 边界 和 一 个 填充 类 型 参数 ， 设 备 上 下 文 将 使 用 当前 的 画 刷 定义 进行 填充 。 


下 面 的 例子 演示 了 绘制 一 个 绿色 矩形 区 域 ， 它 的 轮 廊 线 是 红色 ， 先 进行 黑色 填充 ， 进 行 蓝 色 
填充 


// 男 一 个 红 边 绿色 的 矩形 

dc.SetPen( *wxRED_PEN); 
dc.SetBrush(*wxGREEN_BRUSH) ; 
dc.DrawRectangle(10, 10, 100, 100); 
dc.SetBrush(*wxBLACK_BRUSH) ; 

// 将 绿色 区 域 变 成 黑色 

dc.FloodFill(50, 50, *wxGREEN, wxFLOOD_SURFACE); 
dc.SetBrush(*wxBLUE_BRUSH) ; 

// 开始 填充 茧 色 (直到 遇 到 红色 ) 

dc.FloodFill(50, 50, *wxRED, wxFLOOD_BORDER); 


如 果 找 不 到 指定 的 颜色 ， 这 个 函数 可 能 返回 失败 ， 如 果 指 定 的 点 在 当前 区 域 以 外 ， 这 个 男 数 
也 将 返回 失败 。 这 个 函数 不 支持 打印 设 各 上 下 文 以 及 wxMetafileDC。 


逻辑 函数 


逮 辑 范 数 指定 在 绘画 时 ， 源 象 素 怎 样 和 目标 象 素 进行 合并 操作 ， 黑 认 的 wxCOPY 只 是 使 用 源 
象 素 取代 目标 象 素 。 其 它 的 值 则 指定 了 一 种 逻辑 操作 。 上 比如 wxINVERT 指 定 将 目标 象 素 的 值 取 
反 作 为 新 的 值 ， 这 通常 被 用 来 绘制 临时 边框 ， 因 为 使 用 这 种 方法 进行 绘图 在 第 二 次 以 同样 的 
方法 绘图 的 时 候 将 会 恢复 原样 。 


下 面 的 例子 演示 了 怎样 绘制 一 条 点 线段 ， 然 后 再 将 相关 区 域 恢复 原来 的 样子 。 


wxPen pen(*wxBLACK, 1, wxDOT); 
dc.SetPen(pen); 

// ARR 3 H Be h 
dc.SetLogicalFunction(wxINVERT ); 
dc.DrawLine(10, 10, 100, 100); 
// 再 次 绘制 

dc.DrawLine(10, 10, 100, 100); 
// 恢复 正常 绘制 方法 
dc.SetLogicalFunction(wxCOPY) ; 


逮 辑 函数 的 另外 一 个 用 法 是 通过 组 合 的 方式 创建 新 的 图 形 。 例 如 ， 我 们 可 以 用 下 面 的 方法 来 
通过 一 个 图 片 创 建 一 组 对 应 的 拼图 游戏 需要 的 方块 。 首 先 在 一 幅 白 色 背 景 的 图 片上 使 用 固定 
但 是 随机 的 大 小 创建 一 个 黑色 轮廓 线 的 网 格 作为 拼图 板 的 边界 ， 然 后 对 于 每 一 个 网 格 小 块 ， 
使 用 flood- 人 fi 的 方法 将 其 填充 成 黑色 以 便 创 建 一 个 白色 背景 上 的 黑色 小 方块 ， 然 后 使 用 
wxXAND_REVERSE 这 辑 加 数 将 原 图 Blit 到 这 个 模板 ， 这 样 作 的 结果 是 使 得 方块 内 的 部 分 变 成 
原 图 ， 而 白色 的 背景 则 变 成 黑色 的 背景 ， 然 后 我 们 再 指定 黑色 为 透明 色 创 建 一 个 wxlmage， 
然后 将 其 转换 成 透明 的 wxBitmap 对 象 ， 就 可 以 直接 在 拼图 游戏 中 使 用 了 。 (注意 这 样 的 作法 
需要 原 图 中 没有 黑色 ， 否 则 在 拼图 小 方块 中 就 会 出 现 没 有 颜色 的 容 麻 了 ) 。 


下 表 列 出 了 所 有 的 逻辑 图 数 以 及 它们 的 含义 : 


逻辑 图 数 

wxAND 
wxAND_INVERT 
wxAND_REVERSE 
wxCLEAR 
wxCOPY 
wxEQUIV 
wxINVERT 
wxNAND 

wxNOR 
wxNO_OP 

wxOR 
wxOR_INVERT 
wxOR_REVERSE 
wxSET 
wxSRC_INVERT 
wxXOR 


合 义 (src = 源 , dst = 目的 ) 
src AND dst 

(NOT src) AND dst 

src AND (NOT dst) 

0 

src 

(NOT src) XOR dst 

NOT dst 

(NOT src) OR (NOT dst) 
(NOT src) AND (NOT dst) 
dst 

src OR dst 

(NOT src) OR dst 

src OR (NOT dst) 

1 

NOT src 

src XOR dst 


5.4 使 用 打印 框架 


我 们 已 经 介绍 过 ， 可 以 直接 使 用 wxPrinterDC 来 进行 打印 。 一 个 更 灵活 的 方法 是 使 用 
wxWidgets 提 供 的 打印 框架 来 驱动 打印 机 。 要 使 用 这 个 框架 ， i ee aT 
wxPrintoutt RE x, ERER a KAES | ieee 页 (OnPrintPage) ,总 
o (GelPagslhfo) ,进行 页 面 设置 (OnPreparePrinting) 等 等 。 Tava e 

显示 打印 对 话 框 ， E eee 2X, 同一 个 wxPrintout 
类 类 将 被 打 印 和 预览 功能 一 起 使 用 。 


当 要 开始 打印 的 时 候 ， 一 个 wxPrintout 对 象 实例 被 传递 给 wxPrinter 对 象 ， 然 后 将 调用 Print 函 数 
开始 打印 过 程 ， 并 且 在 准备 打印 用 户 指定 的 那些 页 面前 显示 一 个 打印 对 话 框 。 如 下 面 例子 中 
BU AB 4. 


// 一 个 全 局 变量 用 来 存储 打印 相关 的 设置 信息 
wxPrintDialogData g_printDialogData; 
// 用 户 从 主 菜 单 中 选择 打印 命令 以 后 
void MyFrame: :OnPrint(wxCommandEvent& event) 
wxPrinter printer(& g_printDialogData); 
MyPrintout printout(wxT("My printout")); 
if (!printer.Print(this, &printout, true)) 
{ 
if (wxPrinter::GetLastError() == wxPRINTER_ERROR) 
wxMessageBox(wxT("There was a problem printing.\nPerhaps your current printer 
is not set correctly?"), wxT("Printing"), wxOK); 
else 


wxMessageBox(wxT("You cancelled printing"), 
wxT("Printing"), wxOK); 


else 
(*g_printDialogData) = printer.GetPrintDialogData(); 
} 
二 


因为 打印 范 数 在 所 有 的 页 面 都 已 经 被 泻 染 和 发 送 到 打印 机 以 后 才 会 返回 ， 因 此 wxPrintout 对 象 
可 以 以 局 部 变量 的 方式 创建 。 


wxPrintDialogData 对 象 用 来 存储 所 有 打印 有 关 的 数据 ， 比 如 用 户 选择 的 页 面 和 份 数 等 。 将 其 
保存 在 一 个 全 局 变量 中 并 且 在 下 次 调用 的 时 候 传递 给 wxPrinter 对 象 是 一 个 不 错 的 习惯 ， 因 此 
象 上 面 代 码 中 演示 的 那样 ， 在 创建 wxPrinter 的 时 候 传 递 给 它 一 份 全 局 配置 数据 的 指针 ， 并 在 
Print 函 数 成 功 返 回 以 后 将 当前 的 打印 数据 保存 在 全 局 变量 里 (当然 ， 一 个 更 专业 的 作法 是 将 
其 保存 在 你 的 应 用 程序 类 中 ) 。 关 于 使 用 打印 和 页 面 设置 对 话 框 的 详情 请 参考 第 8 章 ， 合 使 用 
标准 对 话 框 命 。 


如 果 要 创建 打印 预览 ， 你 需要 创建 一 个 wxPrintPreview 对 象 ， 给 这 个 对 象 传递 两 个 wxPrintout 
对 象 作 为 参数 ， 一 个 用 于 预览 ， 一 个 则 用 于 在 用 户 预 览 的 时 候 直接 请 求 打印 ， 同 样 的 ， 你 可 
以 传递 一 个 全 局 的 wxPrintDialogData 对 象 给 预览 对 象 以 便 预览 类 使 用 用 户 以 前 选择 的 打印 设 


置 数 据 。 然 后 将 这 个 预览 类 传递 给 wxPreviewFrame， 然 后 调用 wxPreviewFrame 的 Initialize 画 
数 和 Show 孙 数 显示 这 个 窗口 ， 如 下 所 示 : 


// 用 户 选 择 打 印 预览 菜单 命令 
void MyFrame: :OnPreview(wxCommandEvent& event) 
{ 
wxPrintPreview *preview = new wxPrintPreview( 
new MyPrintout, new MyPrintout, 
& g_printDialogData); 
if (!preview->0k() ) 


delete preview; 
wxMessageBox(wxT("There was a problem previewing.\nPerhaps your current printer i 
not set correctly?"), 
wxT("Previewing"), wxOK); 

return; 
} 
wxPreviewFrame *frame = new wxPreviewFrame(preview, this, 

wxT("Demo Print Preview")); 

frame->Centre(wxBOTH) ; 
frame->Initialize(); 
frame->Show(true); 





当 打 印 预览 窗口 被 初始 化 的 时 候 ， 它 将 禁用 所 有 其 它 的 顶层 窗口 以 确保 任何 可 能 导致 正在 预 
览 或 者 打印 的 文档 内 容 发 生 改变 的 可 能 。 ee 导致 两 个 wxPrintout 对 象 自动 被 释 
放 。 下 图 显示 了 预览 窗口 的 样子 ， 可 以 看 到 它 内 含 IAZ, ARET Amm, FEN 
以 及 缩放 控制 等 功能 。 


wxWidgets 跨 平台 GUI 编程 


i; Demo Print Preview TBR 


Pest message:-this if in 10 point text 





关于 wxPrintout 的 更 多 内 容 


当 创 建 wxPrintout 对 象 的 时 候 ， 你 可 以 传递 一 个 可 选 的 标题 参数 ， 在 某 些 操作 系统 上 ， 这 个 标 
题 将 显示 在 打印 管理 器 上 。 另外 ， 要 重 载 一 个 wxPrintout 对 象 ， 你 至 少 需要 重 载 GetPagelnfo， 
HasPage 和 OnPrintPage 本 数 ， 当 然 ， 下 面 介绍 的 这 些 范 数 你 都 可 以 视 需 要 进行 重 载 。 


到 


首先 来 介绍 GetPagelnfo 画 数 ， 它 用 来 返回 最 小 页 码 ， 最 大 页 码 ， 开 始 打印 页 码 和 结束 打印 页 
码 。 前 两 个 参数 用 来 提供 一 个 可 以 打印 的 范围 ， 后 两 个 参数 被 设计 来 反应 用 户 选 择 的 页 码 范 
围 ， 不 过 目前 没有 用 处 。 最 小 页 面 的 默认 值 为 1, 最 大 页 码 的 默认 值 为 32000, 不 过 当 HasPage 
豆 数 返回 False 的 时 候 ，wxPrintout 类 也 将 停止 打印 。 通 常情 况 下 ， 你 的 OnPreparePrinting 应 
该 计算 当前 打印 内 容 在 当前 设置 下 的 打印 页 数 ， 将 其 保存 在 一 个 成 员 变 量 中 ， 以 便 
GetPagelnfo 琅 数 返 回 正确 的 值 ， 如 下 所 示 : 


i 


void MyPrintout::GetPageInfo(int *minPage, int *maxPage, 
int *pageFrom, int *pageTo) 


*minPage = 1; *maxPage 
*pageFrom = 1; *pageTo 


m_numPages; 
m_numPages; 
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而 HasPage 画 函数 则 用 来 返回 是 否 拥有 某 个 页 码 ， 如 果 这 个 页 码 超 出 了 最 大 页 码 的 范围 则 必须 
返回 False。 通 常 你 的 实现 类 似 下 面 的 样子 : 


bool MyPrintout::HasPage(int pageNum) 


return (pageNum &gt;= 1 && pageNum &lt;= m_numPages); 
} 


OnPreparePrinting 在 预览 或 者 打印 过 程 刚 开始 的 时 候 被 调用 ， 重 载 它 使 得 应 用 程序 可 以 进行 
各 种 设置 工作 ， 比 如 计算 文档 的 总 页 数 等 。OnPreparePrinting 可 以 调用 wxPrintout 的 
GetDC，GetPageSizeMM，l|sPreview 等 函数 ， 因 此 方便 获取 这 些 信息 。 


OnBeginDocument 是 在 每 次 每 篇 文档 即将 开始 打印 的 时 候 被 调用 的 ， 如 果 这 个 函数 被 重 载 
了 ， 那 么 必须 在 重 载 的 函数 中 调用 wxPrintout::OnBeginDocument。 同 样 的 
wxPrintout::OnEndDocument 也 必须 被 它 的 重 载 本 数 调 用 。 


OnBeginPrinting 和 OnEndPrinting 函 数 则 是 在 整个 打印 过 程 开 始 和 结束 的 时 候 被 调用 ， 和 当前 
打印 多 少 份 没有 关系 。 


OnPnniagee ties 个 页 码 人 参数 ， 上 应 用 程序 必须 重 坊 这 个 男 数 并 且 在 成 功 打 印 这 一 页 以 后 
返回 true。 这 个 加 数 应 该 使 用 wxPrintout::GetDC 来 取得 打印 设 各 上 下 文 已 经 进行 绘画 (FT 
印 ) 工作 。 


下 面 这 些 琅 数 作为 一 些 工具 函数 ， 你 可 以 在 你 的 重 载 画 数 中 使 用 它们 ， 而 无 需 重 载 它 们 。 
lsPreview 本 数 用 来 检测 当前 正 处 于 一 个 预览 过 程 中 还 是 一 个 真 的 打印 过 程 中 。 


GetDC 画 数 为 当前 正在 进行 的 工作 返回 一 个 合适 的 设备 上 下 文 。 如 果 是 在 真实 的 打印 过 程 
中 ， 则 返回 一 个 wxPrinterDC， 如 果 是 预览 ， 则 返回 一 个 wxMemoryDC， 因 为 预览 其 实 是 在 一 
个 位 图 上 通过 内 存 设备 上 下 文 来 泻 染 的 。 


CRIP aye oN E 单位 返回 当前 打印 页 面 的 大 小 。GetPageSizePixels 则 以 象 素 为 单 
位 返回 这 个 值 (打印 机 的 最 大 分 辩 率 ) 。 如 果 是 在 预览 过 程 中 ， 这 个 大 小 和 wxDC::GetSize 返 
回 的 值 通 常 是 不 一 样 大 的 (参见 下 面 的 说 明 ) ，wxDC::GetSize 返 回 用 于 预览 的 位 图 的 大 小 。 


GetPPIPrinter 返 回 当前 设备 上 下 文 每 一 个 英寸 对 应 的 象 素 的 数目 ， 而 GetPPIScreen 则 返回 当 
前 屏幕 上 每 英寸 对 应 的 象 素 的 数目 。 


打印 和 预览 过 程 中 的 缩放 


当 你 在 窗口 上 绘画 的 时 候 ， 你 可 能 不 大 关心 图 片 的 缩放 ， 因 为 显示 器 的 分 辨 率 大 部 分 都 是 相 
同 的。 然后 ， 在 面 对 一 个 打印 机 的 时 候 ， 有 几 方 面 的 因素 可 能 导致 你 必须 关心 这 个 问题 : 


片 的 位 置 来 保证 图 片 位 于 某 个 页 面 之 内 ， 在 某 种 情况 下 ， 你 其 
可 能 需要 把 一 个 图 片 分 成 两 半 。 


字体 都 是 基于 屏幕 分 辩 率 的 ， 因 此 在 打印 文本 的 时 候 ， 你 需要 设置 一 个 合适 的 缩放 的 值 ， 以 
便 使 打印 设备 上 下 文 符 合 屏幕 的 分 辩 率 。 在 打印 文本 的 时 候 ， 通 过 应 该 设置 通过 用 
GetPPIPrinter 的 值 除 以 GetPPIScreen 的 值 计 算 而 得 的 值 作为 缩放 因子 的 值 。 


当 泻 染 预 览 图 案 的 时 候 ，wxWidgets 使 用 了 wxMemoryDC 在 一 个 位 图 上 绘画 。 这 个 位 图 的 大 
小 (wxDC::GetSize) 是 基于 当前 预览 的 放大 倍数 的 这 就 需要 一 个 人 额外 的 缩放 因子 。 通 常 这 个 
AE 用 GetSize 返 回 的 值 除 以 GetPageSizePixels 返 回 的 实际 页 面 的 象 素 值 来 获 
得 。 通 常 这 个 值 还 应 该 乘 以 别 的 缩放 因子 定义 的 值 。 


你 可 以 调用 wxDC::SetUserScale 来 设置 设备 上 下 文 的 缩放 因子 ， 使 用 wxDC::SetDeviceOrigin 
来 设置 平移 因子 (例如 ， 需 要 把 一 个 图 片 放置 在 页 面 正中 的 时 候 ) 。 如 果 有 必要 的 话 ， 你 其 
至 可 以 在 同一 个 页 面 绘画 的 时 候 反 复 使 用 不 同 的 值 来 调用 这 两 个 辑 数 。 


wxWidgets 的 例子 中 的 samples/printing 演 示 了 怎样 在 打印 过 程 中 使 用 缩放 ， 下 面 列 出 的 代码 
是 其 中 进行 缩放 的 适 配 代码 ， 它 将 演示 了 在 打印 过 程 中 和 预览 过 程 中 将 一 幅 大 小 为 200x200 象 
素 的 图 片 进行 了 缩放 和 放置 ， 如 下 所 示 : 


void MyPrintout: :DrawPageOne(wxDC *dc) 
{ 
// 下 面 的 代码 可 以 这 样 写 只 是 因为 我 们 知道 图 片 的 大 小 是 200x200 
// 如 果 我 们 不 知道 的 话 ， 需 要 先 计算 图 片 的 大 小 
float maxX = 200; 
float maxY = 200; 
// 让 我 们 先 设置 至 少 50 个 设 各 单位 的 边框 
float marginx = 50; 
float marginY = 50; 
// 将 边框 的 大 小 增加 到 图 片 的 周围 
maxX += (2*marginX); 
maxY += (2*marginyY); 
获取 象 素 单 位 的 当前 设备 上 下 文 的 大 小 
int w, h; 
dc->GetSize(&w, &h); 
// 计 算 一 个 合适 的 缩放 值 
float Scalex=(float )(w/maxx) ; 
float scaleY=(float)(h/maxyY) ; 
// 选择 X 或 者 Y 方 向 上 较 小 的 那个 
float actualScale = wxMin(scalex,scaleyY); 
// 计算 图 片 在 设备 上 的 合适 位 置 以 便 居 中 
float poSX = (float)((w - (200*actualScale))/2.0); 
float posY = (float)((h - (200*actualScale))/2.0); 
// 设置 设备 平移 和 缩放 
dc->SetUserScale(actualScale, actualScale); 
dc->SetDeviceOrigin( (long)posxX, (long)posyY ); 
// ok, 现在 开始 画 画 
dc.SetBackground(*wxWHITE_BRUSH ; 
dc.Clear(); 
dc.SetFont(wxGetApp().m_testFont) ; 
dc .SetBackgroundMode(wxTRANSPARENT ) ; 
dc.SetBrush(*wxCYAN_BRUSH) ; 
dc.SetPen( *wxRED_PEN); 
dc.DrawRectangle(0, 30, 200, 100); 
dc.DrawText( wxT("Rectangle 200 by 100"), 40, 40); 
dc.SetPen( wxPen(*wxBLACK,0,wxDOT_DASH) ); 
dc.DrawEllipse(50, 140, 100, 50); 
dc.SetPen( *wxRED_PEN); 
dc.DrawText( wxT("Test message: this is in 10 point text"), 
10, 180); 


在 上 面 的 例子 中 ， 我 们 只 是 简单 的 使 用 wxDC::GetSize 来 得 到 打印 设备 或 者 预览 图 像 的 分 辩 
率 ， 以 便 我 们 能 够 把 要 打印 的 图 像 放 到 合适 的 位 置 。 我 们 没有 关心 类 似 每 一 个 英寸 多 少 个 点 
这 样 的 信息 ， 因 为 我 们 不 需要 画 精 度 很 高 的 文本 或 者 是 线段 。 图 片 不 需要 很 高 的 精度 ， 因 此 
我 们 只 是 进行 简单 的 缩放 以 便 它 能 够 被 合适 的 放置 ， 不 致 于 太 大 太 小 或 者 越界 就 可 以 了 。 


接 下 来 ， 我 们 演示 一 下 怎样 进行 精度 很 高 的 文本 或 者 线段 的 打印 以 便 看 上 去 它 和 显示 在 屏幕 
上 的 是 一 致 的 。 而 不 是 只 是 进行 简 ja] 单 的 缩放 : 


void MyPrintout: :DrawPageTwo(wxDC *dc) 

{ 
// 你 可 以 使 用 下 面 的 代码 来 设置 打印 机 以 便 其 可 以 反应 出 文本 在 屏幕 上 的 大 小 
// 另外 下 面 的 代码 还 将 打印 一 个 5cm 长 的 线段 。 
// 首先 获得 屏幕 和 打印 机 上 各 自 的 1 英寸 的 逻辑 象 素 个 数 
int ppiScreenX, ppiScreeny; 
GetPPIScreen(&ppiScreenx, &ppiScreeny) ; 
int ppiPrinterX, ppiPrinteryY; 
GetPPIPrinter(&ppiPrinterX, &ppiPrinteryY); 
// 这 个 缩放 因子 用 来 大 概 的 反应 屏幕 到 实际 打印 设备 的 一 个 缩放 
float scale = (float)((float)ppiPrinterX/(float)ppiScreenx) ; 
// 现在 ， 我 们 还 需要 考虑 页 面 缩放 
// (比如 : 我 们 正在 作 打印 预览 ， 用 户 选 择 了 一 个 缩放 级 别 ) 
int pageWidth, pageHeight; 
int w, h; 
dc->GetSize(&w, &h); 
GetPageSizePixels(&pageWidth, &pageHeight); 
// 如 果 打印 设备 的 页 面 大 小 pagewidth == 当前 DC 的 大 小 ， 就 不 需要 考虑 这 方面 的 缩放 了 
// 但 是 它们 有 可 能 是 不 一 样 的 
// 因此 ， 缩 放 吧 ， 
float overallScale = scale * (float)(w/(float)pageWidth); 
dc->SetUserScale(overallScale, overallScale); 
// 现在 我 们 来 计算 每 个 逻辑 单位 有 多 少 个 毫米 
// 我 们 知道 1 英寸 大 概 是 25 .4 毫米 .而 ppii 
// 代表 的 是 以 英寸 为 单位 的 .因此 1 毫米 就 等 于 ppi/25 .4 个 设备 单位 
// 另外 我 们 还 需要 再 除 以 我 们 的 缩放 因子 scale 
// GER: 为 什么 这 里 是 scale 而 不 是 overallScale? ) 
// (其 实 overal1Scale 比 scale 而 言 ， 多 了 一 个 预览 的 缩放 ) 
// 【而 在 预览 的 时 候 ， 我 们 是 希望 线段 的 长 度 按照 用 户 设置 的 比例 变化 的 ) 
// 因为 我 们 的 设备 已 经 被 设置 了 缩放 因子 
// 现在 让 我 们 来 画 一 个 长 度 为 50mm 的 L 图 案 
float logUnitsFactor = (float)(ppipPrinterX/(scale*25.4)); 
float logUnits = (float)(50*logUnitsFactor); 
dc->SetPen(* wxBLACK_PEN); 
dc->DrawLine(50, 250, (long)(50.0 + logUnits), 250); 
dc->DrawLine(50, 250, 50, (long)(250.0 + logUnits)); 
dc->SetBackgroundMode(wxTRANSPARENT ) ; 
dc->SetBrush(*wxTRANSPARENT_BRUSH) ; 
dc->SetFont (wxGetApp().m_testFont); 
dc->DrawText(wxT("Some test text"), 200, 300 ); 


在 类 Unix 系 统 上 的 GTK+ 版 本 上 的 打印 


和 Mac OS X 以 及 Windows 系 统 不 同 ，Unix 系 统 没 有 提供 一 个 标准 的 API 同 时 支持 在 屏幕 上 显 
示 文 本 图 片 和 在 打印 机 上 打印 文本 和 图 片 。 实 际 上 ， 在 类 Unix 系 统 中 ， 屏 幕 显示 是 通过 X11 库 
(被 GTK+ 封 装 又 被 wxWidgets 封 装 ) 实现 的 ， 而 打印 要 通过 发 送 PostScript 命 令 到 打印 机 来 
完成 。 而 这 两 种 情况 下 使 用 不 同 的 字体 都 是 一 个 麻烦 。 直 到 最 近 ， 才 有 很 少 的 程序 在 类 Unix 
上 提供 了 所 见 即 所 得 的 功能 。 以 前 wxWidgets 提 供 自 己 的 PostScript 实 现 ， 但 是 它 很 难 和 屏幕 
显示 的 内 容 完 全 一 致 。 


从 版 本 2.8 开 始 ，Gnome 项 目 组 开始 通过 libgnomeprint 和 libgnomeprintui 库 来 提供 打印 支持 ， 
这 样 大 多 数 的 打印 问题 才 算 得 以 解决 。 从 wxWidgets 的 版 本 2.5.4 开 始 ，GTK+ 的 版 本 通过 合适 
的 配置 以 后 可 以 支持 这 两 个 库 。 你 需要 使 用 --with- gnomeprint 来 配置 wxWidgets， 这 将 导致 
wxWidgets 在 运行 期 自动 查找 GNOME 打 印 库 。 如 果 找 的 到 ， 就 使 用 它 完 成 打印 ， 否 则 就 使 用 
旧 的 PostScript 打 印 的 代码 。 需 要 说 明 的 是 ， 这 并 不 需要 用 户 的 机 器 上 一 定 要 安装 gnome 的 打 
印 库 程 序 才 可 以 运行 ， 因 为 程序 本 身 并 不 依赖 这 些 库 。 


5.5 使 用 wxGLCanvas 绘 制 三 维 图 形 


感谢 OpenGL 和 wxGLCanvas， 让 wxWidgets 拥 有 了 绘制 三 维 图 形 的 能 力 。 如 果 你 的 平台 不 支 
持 OpenGL， 你 仍然 可 以 使 用 它 的 一 个 开放 源码 的 实现 Mesa。 


要 让 wxWidgets 在 windows 平 台 上 支持 wxGLCanvas， 你 需要 编辑 include/wx/msw/setup.h， 
设置 wxUSE_GLCANVAS 为 1， 然 后 编译 的 时 候 在 命令 行使 用 USE_OPENGL=1， 在 连接 的 
时 候 你 也 可 能 需要 增加 opengl32.lib。 而 在 Unix 或 者 Mac OS X 上 ， 你 只 需要 在 配置 
wxWidgets 的 时 候 增 加 --with-opengl 参 数 来 打开 OpenGL 或 者 Mesa 的 支持 。 


如 果 你 已 经 是 一 个 OpenGL 的 程序 员 ， 那 么 使 用 wxGLCanvas 是 非常 简单 的 。 你 只 需要 在 一 个 
frame 窗 口 或 者 其 他 任何 容器 窗口 内 创建 一 个 wxGLCanvas 对 象 ， 然 后 调用 
wxGLCanvas::SetCurrent 函 数 将 OpenGL 的 命令 指向 这 个 窗口 ， 执 行 OpenGL ws, AIA 
用 wxGLCanvas::SwapBuffers 画 数 将 当前 的 OpenGL 缓 冲 区 的 内 容 绘 制 到 窗口 上 。 


下 面 的 重 绘 事件 处 理 函 数 演示 了 泻 染 一 个 三 维 立方 体 的 一 些 基 本 代码 书写 原则 。 完 整 的 例子 
可 以 在 wxWidgets 发 行 版 本 中 的 samples/openglcube 目 录 中 找到 。 


void TestGLCanvas: :OnPaint(wxPaintEvent& event) 

{ 
wxPaintDC dc(this); 
SetCurrent(); 
glMatrixMode(GL_PROJECTION) ; 
glLoadIdentity(); 
glFrustum(-0.5f, 0.5f, -0.5f, 0.5f, 1.0f, 3.0f); 
glMatrixMode(GL_MODELVIEWw) ; 
/* 清除 颜色 和 深度 缓冲 */ 
glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); 
/* 绘制 一 个 立方 体 的 六 个 面 */ 
g1lBegin(GL_QUADS); 
glNormal3f( 0.0f, 0.0f, 1.0f); 
glVertex3f( 0.5f, 0.5f, 0.5f); glVertex3f(-0.5f, 0.5f, 0.5f); 
glVertex3f(-0.5f,-0.5f, 0.5f); glVertex3f( 0.5f,-0.5f, 0.5f); 
glNormal3f( 0.0f, 0.0f,-1.0f); 
glVertex3f(-0.5f,-0.5f,-0.5f); glVertex3f(-0.5f, 0.5f,-0.5f); 
glVertex3f( 0.5f, 0.5f,-0.5f); glVertex3f( 0.5f,-0.5f, -0.5f); 
glNormal3f( 0.0f, 1.0f, 0.0f); 
glVertex3f( 0.5f, 0.5f, 0.5f); glVertex3f( 0.5f, 0.5f,-0.5f); 
glVertex3f(-0.5f, 0.5f,-0.5f); glVertex3f(-0.5f, 0.5f, 0.5f); 
glNormal3f( 0.0f,-1.0f, 0.0f); 
glVertex3f(-0.5f,-0.5f,-0.5f); glVertex3f( 0.5f,-0.5f, -0.5f); 
glVertex3f( 0.5f,-0.5f, 0.5f); glVertex3f(-0.5f,-0.5f, 0.5f); 
glNormal3f( 1.0f, 0.0f, 0.0f); 
glVertex3f( 0.5f, 0.5f, 0.5f); glVertex3f( 0.5f,-0.5f, 0.5f); 
glVertex3f( 0.5f,-0.5f,-0.5f); glVertex3f( 0.5f, 0.5f,-0.5f); 
glNormal3f(-1.0f, 0.0f, 0.0f); 
glVertex3f(-0.5f,-0.5f,-0.5f); glVertex3f(-0.5f,-0.5f, 0.5f); 
glVertex3f(-0.5f, 0.5f, 0.5f); glVertex3f(-0.5f, 0.5f,-0.5f); 
glEnd(); 
glFlush(); 
SwapBuffers(); 








wxWidgets FS GUI 编程 


下 图 演示 了 另外 的 一 个 OpenGL 的 例子 ， 一 个 可 爱 的 〈 当 然 ， 有 点 棱角 的 ) 企鹅 ， 在 例子 程序 
中 ， 你 可 以 用 鼠标 来 旋转 它 。 完 整 的 例子 可 以 在 光盘 的 samples/openglypenguin 目 录 中 找到 。 


ne wxWidgets OpenGL Penguin ... 加 回回 
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第 五 章 小 节 


在 本 章 中 ， 你 学 习 了 怎样 使 用 设备 上 下 文 进行 绘画 ， 怎 样 使 用 wxWidgets 提 供 的 打印 框架 ， 还 
看 到 了 一 个 非常 简单 的 使 用 wxGLCanvas 的 介绍 。wxWidgets 的 发 布 包 中 有 几 个 很 本 章 内 容 相 
关 的 例子 ， 列 举 如 下 以 供 参考 。 


e Samples/drawing 

e Samples/font 

e samples/erase 

e samples/image 

e samples/scroll 

e samples/printing 

e src/html/htmprint.cpp 
e demos/bombs 

e demos/fractal 


demosi/life 


对 于 更 高 级 的 二 维 绘 画 应 用 程序 ， 你 可 能 愿意 考虑 使 用 wxArt2D 库 ， 这 个 库 提 供 了 以 SVG 文件 
格式 读 取 和 保存 图 形 对 象 ， 无 闪烁 更 新 ， 过 渡 色 ， 矢 量 路 径 等 等 特性 ， 附 录 E, “wxWidgets 的 
第 三 方 工 具 包 ?包含 了 获取 wxArt2D 的 方法 。 


在 下 一 章 中 ， 我 们 来 看 看 wxWidgets 怎 样 响应 鼠标 ， 键 盘 和 游戏 手柄 输入 。 


第 六 章 处 理 用 户 输入 


所 有 的 GUI 程 序 都 要 以 某 种 方式 响应 用 户 的 输入 ， 这 一 章 我 们 来 介绍 以 下 在 wxWidgets 中 怎样 
处 理 来 自用 户 的 鼠标 ， 键 盘 以 及 游戏 手柄 的 输入 . 


6.1 鼠标 输入 


总 的 说 来 ， 有 两 类 的 鼠标 事件 。 基 本 的 鼠标 事件 使 用 wxMouseEvent 作 为 参数 ， 不 加 任何 翻译 
的 发 送 给 响应 的 窗口 事件 处 理 函 数 ， 而 窗口 事件 处 理 玉 数 则 通常 把 它们 翻译 成 对 应 的 命 合 事 
件 (wxCommandEvent) 。 


举例 来 说 ， 当 你 在 你 的 事件 表 中 增加 EVT_BUTTON 事 件 映射 宏 的 时 候 ， 它 的 处 理 范 数 的 参数 
是 一 个 由 按钮 产生 的 wxCommandEvent 类 型 。 而 在 控件 内 部 ， 这 个 wxCommandEvent 类 型 是 
按钮 控件 对 EVT_LEFT_DOWN 事 件 宏 进行 处 理 并 将 对 应 的 妃 标 事件 翻译 成 
wxCommandEvent 事 件 的 结果 。 (当然 ， 在 大 多 数 平 台 上 ， 按 钮 都 是 使 用 本 地 控件 实现 的 ， 
不 需要 自己 处 理 底 层 的 鼠标 事件 ， 但 是 对 于 别 的 定制 的 类 来 说 ， 确 是 如 此 ) 


因为 我 们 在 前 面 已 经 介绍 过 义理 命令 事件 的 方法 ， 我 们 将 主要 介绍 怎样 义理 基本 的 鼠标 事 
件 。 


你 可 以 分 别 拦截 鼠 标 左 键 ， 中 键 或 者 右键 的 鼠标 按 下 ， 思 标 释放 或 者 鼠标 双击 事件 。 你 还 可 
以 拦截 鼠标 的 移动 事件 (无论 有 没有 鼠标 按 下 ) 。 你 还 可 以 拦截 那些 用 来 告诉 你 鼠标 正在 移 
入 或 者 移出 某 个 窗口 的 事件 ， 最 后 ， 如 果 这 个 鼠标 有 滚轮 ， 你 还 可 以 拦截 鼠标 的 滚轮 事件 。 


当 你 收 到 一 个 鼠标 事件 时 ， 你 可 以 获得 鼠标 按钮 的 状态 信息 ， 以 及 象 Shift，Alt 等 等 这 些 状态 
键 的 信息 ， 你 还 可 以 获得 鼠标 指针 相对 于 当前 窗口 客户 区 域 在 上 角 的 座 标 值 。 


下 表 列 出 了 所 有 对 应 的 鼠标 事件 映射 宏 。 需 要 注意 的 是 ，wxMouseEvent 事 件 是 不 会 传递 给 父 
窗口 处 理 的 ， 所 以 ， 为 了 义理 这 个 事件 ， 你 必须 重 载 一 个 新 的 窗口 类 ， 或 者 重 载 一 个 新 的 
wxEvtHandler， 然 后 将 其 挂 载 在 某 个 窗口 上 ， 当 然 你 还 可 以 使 用 动态 事件 处 理 琅 数 Connect， 
相关 内 容 参 见 第 三 章 。 


EVT_LEFT_DOWN(func 


EVT_LEFT_UP(func) 


EVT_LEFT_DCLICK(func) 


EVT_MIDDLE_DOWN(func) 


EVT_MIDDLE_UP(func) 


EVT_MIDDLE_DCLICK(func) 


EVT_RIGHT_DOWN(func) 


EVT_RIGHT_UP(func) 


EVT_RIGHT_DCLICK(func) 


EVT_MOTION(func) 


EVT_ENTER_WINDOW(func) 


EVT_LEAVE_WINDOW(func) 


EVT_MOUSEWHEEL (func) 


EVT_MOUSE_EVENTS(func) 


用 来 处 理 wxEVT_LEFT_DOWN 事 件 , 在 鼠标 左 键 按 下 
的 时 候 产 生 . 


用 来 处 理 wxEVT_LEFT_UP 事 件 , 在 鼠标 左 键 被 释放 的 
时 候 产 生 . 


用 来 处 理 wxEVT_LEFT_DCLICK 事 件 , 在 鼠标 左 键 被 双 
击 的 时 候 产 生 . 


用 来 人 处理 wxEVT_MIDDLE_DOWN 事 件 , 在 鼠标 中 键 被 
按 下 的 时 候 产 生 . 


用 来 处 理 wxEVT_MIDDLE_UP 事 件 , 当 和 妃 标 中 键 被 释放 
的 时 候 产 生 . 


用 来 处 理 wxEVT_MIDDLE_DCLICK 事 件 ,在 鼠标 中 键 被 
双击 的 时 候 产 生 . 


用 来 处 理 wxEVT_RIGHT_DOWN 事 件 ,鼠标 右键 被 按 下 
的 时 候 产 生 . 


用 来 多 理 wxEVT_RIGHT_UP 事 件 ,鼠标 右键 被 释放 的 时 
候 产 生 . 


用 来 处 理 wxEVT_RIGHT_DCLICK 事 件 , 妃 标 右键 被 双 
击 的 时 候 产 生 . 


用 来 处 理 wxEVT_MOTION 事 件 , 妃 标 指针 移动 的 时 候 产 
生 . 


用 来 处 理 wxEVT_ENTER _WINDOW 事 件 ,鼠标 指针 移 
入 某 个 窗口 的 时 候 产 生 . 


用 来 处 理 wxEVT_LEAVE_WINDOW 事 件 , 妃 标 移出 某 
个 窗口 的 时 候 产 生 . 


用 来 多 理 wxEVT_MOUSEWHEEL 事 件 , 妃 标 滚轮 滚动 
的 时 候 产 生 . 


用 来 人 处理 所 有 的 鼠标 事件 . 


处 理 按钮 和 幢 标 指针 移动 事件 
按钮 和 指针 移动 事件 是 你 想 要 义 理 的 最 主要 的 鼠标 事件 。 


要 检测 当 产 生 某 个 事件 时 状态 键 的 状态 ， 可 以 使 用 AltDown,MetaDown,ControlDown 或 者 
ShiftDown 等 画 数 .使 用 CmdDown 画 数 来 检测 Mac OS X 平 台 上 的 Meta 键 或 者 别 的 平台 上 的 
Control 键 的 状态 .本 章 稍 后 的 "状态 键 变 量 "小 节 会 对 这 些 函 数 进行 更 详细 的 介绍 . 


要 检测 那个 鼠标 按钮 正 被 按 下 ,你 可 以 使 用 LeftlsDown, MiddlelsDown#fRightlsDownkd 8, 3% 
者 你 可 以 使 用 wxMOUSE_BTN_LEFT wxMOUSE_BTN_MIDDLE, wxMOUSE_BTN_RIGHT 
或 wxMOUSE_BTN_ANY 参 数 来 调用 Button 画 数 .要 注意 这 些 酌 数 通常 只 是 反应 在 事件 产生 那 
个 时 刻 鼠 标的 状态 ,而 不 是 反应 鼠标 的 状态 改变 .( 译 者 注 : 换 名 话说 ,两 续 同 样 按钮 的 两 个 事件 中 
的 按钮 状态 可 能 是 一 样 的 ). 


在 Mac OS X 上 ,Command 键 被 翻译 成 Meta,Option 键 是 Alt. 因 为 在 Mac 系 统 上 通常 使 用 的 是 一 
键 鼠 标 , 当 用 Eon 击 鼠 标的 时 候 将 产生 右键 单 击 事件 .因此 在 MacOS 上 没有 按 下 
Control 键 时 进行 右键 单 击 这 样 的 事件 ,除非 你 正在 使 用 的 是 一 个 两 键 或 者 三 键 的 鼠标 . 


你 还 可 以 用 下 面 的 函数 来 或 者 鼠标 事件 的 类 型 :Dragging ( 某 个 键 正 按 下 时 鼠标 移动 ), Moving 
(鼠标 正在 移动 而 没有 鼠标 键 被 按 下 ), Entering, Leaving, ButtonDown, ButtonUp, 
ButtonDClick, LeftClick, LeftDClick, LeftUp, RightClick, RightDClick, RightUp, ButtonUp 和 
IsButton=. 
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下 面 的 例子 演示 了 一 个 涂 禾 程序 中 的 最 标 处 理 过 程 : 


BEGIN_EVENT_TABLE(DoodleCanvas, wxWindow) 
EVT_MOUSE_EVENTS(DoodleCanvas: :OnMouseEvent ) 

END_EVENT_TABLE( ) 

void DoodleCanvas: :OnMouseEvent (wxMouseEvent& event) 


static DoodleSegment *s_currentSegment = NULL; 
wxPoint pt(event.GetPosition()); 
if (s_currentSegment && event.LeftUp()) 


// 鼠标 按钮 释放 的 时 候 停 止 当前 线段 
if (s_currentSegment->GetLines().GetCount() == 0) 


// 释放 线段 记录 并 且 释放 指针 
delete s_currentSegment; 
s_currentSegment = (DoodleSegment *) NULL; 


} 

else 

{ 4 大 | 
// 已 经 得 到 一 个 有 效 的 线段 , 把 它 存 下 来 
DrawingDocument *doc = GetDocument(); 
doc->GetCommandProcessor ( ) ->Submit ( 
new DrawingCommand(wxT("Add Segment"), DOODLE_ADD, 

doc, s_currentSegment) ); 

doc->Modify(true); 
s_currentSegment = NULL; 

} 

else if (m_lastX &gt; -1 && m_lastY &gt; -1 && event.Dragging()) 


{ 
// 正 在 拖 动 鼠标 , 增加 一 行 到 当前 的 线段 中 
if (!s_currentSegment ) 
s_currentSegment = new DoodleSegment; 
DoodleLine *newLine = new DoodleLine(m_lastX, m_lastY, pt.x, pt.y); 
s_currentSegment ->GetLines().Append(newLine) ; 
wxClientDC dc(this); 
DoPrepareDC(dc); 
dc.SetPen( *wxBLACK_PEN); 
dc.DrawLine( m_lastX, m_lastY, pt.x, pt.y); 


m_lastX = pt.x; 
m_lastY = pt.y; 


在 上 面 的 应 用 程序 中 ,线段 被 存在 文档 类 型 . 当 用 户 使 用 饥 标 左 键 在 窗口 上 拖 搜 时 ,上 面 的 函数 增 
加 一 个 线条 到 当前 的 线段 中 ,并 且 把 它 画 出 来 , 当 用 户 释 放 左 键 的 时 候 , 当 前 的 线段 被 提交 到 文 
档 类 进行 处 理 (文档 类 是 wxWidgets 的 文档 视图 框架 的 一 部 分 ) ,以 便 进一步 实现 文档 的 重 做 或 


者 撤消 动作 ,而 在 窗口 的 OnPaint 函 数 (代码 没有 被 展示 ) 中 ,整个 文档 被 重 绘 .在 第 19 章 "使 用 文档 
和 视图 "中 ,我 们 会 完整 的 介绍 这 个 例子 . 


如 果 想 让 这 个 程序 更 专业 一 点 ,可 以 在 鼠标 按 下 的 时 候 捕 获 鼠 标 并 且 在 鼠标 释放 的 时 候 释 放 捕 
获 ,以 便当 鼠标 左 键 按 下 并 且 移 出 窗口 的 时 候 仍 然 可 以 收 到 鼠标 事件 . 


义理 鼠标 滚轮 事件 


当 义 理 鼠 标 滚轮 事件 的 时 候 ,你 可 以 使 用 GetWheelRotation 画 数 获得 滚轮 滚 过 的 位 置 的 大 小 (可 
能 为 负数 ). 用 这 个 数 除 以 GetWheelDelta 以 便 得 到 实际 滚动 行 数 的 值 .多 数 的 设备 每 个 
GetWheelDelta 发 送 一 个 滚轮 事件 ,但 als cna ean ace call 因此 你 需 
进行 这 种 计算 以 便 只 有 在 滚轮 滚 过 一 整 行 的 时 候 示 滚动 窗口 ,或 者 如 果 你 可 以 滚动 半 行 也 可 以 . 
你 还 要 把 用 户 在 控制 面板 中 设置 的 滚轮 每 次 滚动 数量 计算 进去 ,这 个 数目 可 以 通过 
GetLinesPerAction 画 数 获得 ,要 乘 以 这 个 值 来 得 到 实际 用 户 希 望 滚动 的 数量 . 


另外 ,鼠标 滚轮 还 可 以 被 设置 为 每 次 滚动 一 页 ,你 需要 调用 IsPageScroll 本 数 来 判断 是 否 属 于 这 
种 情况 . 


我 们 来 举 个 例子 ,下 面 的 代码 是 wxScrolledWindow 的 默认 滚轮 处 理事 件 处 理 函 数 , 其 中 的 变量 
m_wheelRotation 对 已 经 滚动 的 位 置 进 行 累加 ,只 有 在 滚动 超过 一 行 的 时 候 才 进行 滚动 . 


void wxScrollHelper: :HandleOnMousewheel(wxMouseEvent& event) 


{ 
m_wheelRotation += event.GetwheelRotation(); 
int lines = m_wheelRotation / event.GetWheelDelta(); 


m_wheelRotation -= lines * event.GetwheelDelta(); 
if (lines != 0) 
{ 


wxScrollwWinEvent newEvent; 

newEvent ..SetPosition(@); 

newEvent .SetOrientation(wxVERTICAL ) ; 
newEvent.m_eventObject = m win; 

if (event.IsPageScroll()) 


if (lines &gt; 0) 

newEvent.m_eventType = wxEVT_SCROLLWIN_PAGEUP; 
else 

newEvent.m_eventType = wxEVT_SCROLLWIN_PAGEDOWN,; 
m_win->GetEventHandler()->ProcessEvent (newEvent ); 


} 
else 
{ 
lines *= event.GetLinesPerAction(); 
if (lines &gt; 0) 
newEvent.m_eventType = wxEVT_SCROLLWIN_LINEUP,; 
else 
newEvent.m_eventType = wxEVT_SCROLLWIN_LINEDOWN,; 
int times = abs(lines); 
for (; times &gt; 0; times) 
m_win->GetEventHandler ()->ProcessEvent(newEvent ); 
} 


6.2 义理 键盘 事件 


键盘 事件 是 由 wxKeyEvent 类 表示 的 .总 共有 三 种 不 同类 型 的 键 盘 事件 ,分 别 为 : 键 按 下 , 键 释放 和 
字符 事件 . 键 按 下 和 键 释放 事件 是 原始 事件 ,而 字符 事件 是 翻译 事件 ,我 们 马上 会 描述 字符 事件 ， 
不 过 在 这 之 前 先 要 清楚 ,如 果 一 个 按键 被 长 时 间 按 下 ,你 通常 就 收 到 很 多 个 键 按 下 事件 ,而 只 收 到 
一 个 键 释放 事件 ,, 因 此 不 要 以 为 一 个 键 释放 事件 一 定 对 应 一 个 键 按 下 事件 ,这 种 想法 是 错误 的 . 


要 想 接 收 到 键 瘟 事件 ,你 的 窗口 必须 拥 ns an 焦点 这 可 以 通过 男 数 wxWindow::SetFocus 来 设 
置 ,比如 当 妃 标点 击 窗口 的 时 候 可 以 调用 这 mE. 


下 表 列 出 了 对 应 的 事件 映射 宏 
EVT_KEY_DOWN(func) 用 来 处 理 wxEVT_KEY_DOWN 事 件 (原始 按键 按 下 事件 ). 
EVT_KEY_UP(func) 用 来 处 理 wxEVT_KEY_UP 事 件 (原始 的 按键 释放 ). 
EVT_CHAR(func) 用 来 人 处理 wxEVT_CHAR 事 件 (已 经 翻译 的 按键 按 下 事件 ). 
接 下 来 描述 一 下 你 可 以 在 事件 处 理 画 数 中 使 用 的 处 理 函 数 . 


要 获得 按键 编码 ,你 可 以 使 用 GetKeyCode 画 数 (在 Unicode 版 本 中 ,你 还 可 以 使 用 
GetUnicodeKeyCode 画 数 ). 下 表 列 出 了 所 有 的 按键 编码 : 


WXK_BACK WXK_RIGHT 
WXK_TAB WXK_DOWN 
WXK_RETURN WXK_SELECT 
WXK_ESCAPE WXK_PRINT 
WXK_SPACE WXK_EXECUTE 
WXK_DELETE WXK_SNAPSHOT 
WXK_INSERT WXK_START 
WXK_HELP WXK_LBUTTON 


WXK_RBUTTON 


WXK_NUMPADO 


WXK_CANCEL WXK_NUMPAD1 
WXK_MBUTTON WXK_NUMPAD2 
WXK_CLEAR WXK_NUMPAD3 
WXK_SHIFT WXK_NUMPAD4 
WXK_CONTROL WXK_NUMPAD5 
WXK_MENU WXK_NUMPAD6 


WXK_PAUSE 
WXK_CAPITAL 
WXK_PRIOR 
WXK_NEXT 
WXK_MULTIPLY 
WXK_ADD 
WXK_SEPARATOR 
WXK_SUBTRACT 
WXK_PAGEDOWN 
WXK_NUMPAD_SPACE 
WXK_NUMPAD_ TAB 
WXK_NUMPAD_ENTER 
WXK_NUMPAD_F1 
WXK_NUMPAD_ F2 
WXK_NUMPAD_F3 
WXK_NUMPAD_F4 
WXK_NUMPAD_HOME 
WXK_NUMPAD_LEFT 
WXK_NUMPAD_UP 
WXK_NUMPAD_ RIGHT 
WXK_NUMPAD_DOWN 
WXK_NUMPAD_ PRIOR 
WXK_NUMPAD_PAGEUP 
WXK_NUMPAD_NEXT 
WXK_NUMPAD_PAGEDOWN 
WXK_NUMPAD_END 
WXK_NUMPAD_ BEGIN 
WXK_NUMPAD_ INSERT 
WXK_NUMPAD_ DELETE 
WXK_NUMPAD_EQUAL 
WXK_NUMPAD_ MULTIPLY 
WXK_NUMPAD_ADD 


WXK_NUMPAD7 
WXK_NUMPAD8 
WXK_NUMPAD9 
WXK_END 
WXK_HOME 
WXK_LEFT 
WXK_UP 
WXK_DECIMAL 
WXK_DIVIDE 
WXK_F1 
WXK_F2 
WXK_F3 WXK_F4 
WXK_F5 
WXK_F6 
WXK_F7 
WXK_F8 
WXK_F9 
WXK_F10 
WXK_F11 
WXK_F12 
WXK_F13 
WXK_F14 
WXK_F15 
WXK_F16 
WXK_F17 
WXK_F18 
WXK_F19 
WXK_F20 
WXK_F21 
WXK_F22 
WXK_F23 
WXK_F24 


WXK_NUMPAD_SEPARATOR WXK_NUMPAD_SUBTRACT 


WXK_NUMLOCK WXK_NUMPAD_DECIMAL 
WXK_SCROLL WXK_NUMPAD_ DIVIDE 
WXK_PAGEUP 


要 判断 在 按键 的 时 候 是 否 有 状态 键 按 下 ,可 以 使 用 AltDown, MetaDown, ControlDown 或 者 
ShiftDownEi2X. HasModifiers 画 数 在 有 Control 或 者 Alt 键 按 下 的 时 候 返 回 True( 不 包括 Shift 和 
Meta 键 ). 


你 可 以 使 用 CmdDown 画 数 来 代替 ControlDown 或 者 MetaDown 画 数 , 它 在 Mac OSX 上 调用 
MetaDown 而 在 别 的 平台 上 调用 ControlDown .在 接 下 来 的 部 分 会 对 此 进行 解释 . 


GetPosition 画 数 返 回 按键 的 时 候 的 鼠标 指针 相对 于 窗口 客户 区 原点 的 位 置 . 


提示 :如 果 你 在 键盘 事件 义理 画 数 中 没有 调用 event.Skip() 函 数 ,对 应 的 字符 事件 将 不 会 产生 .在 
某 些 平台 上 ,全 局 的 快捷 键 也 会 不 起 作用 . 


字符 事件 处 理 的 例子 


下 面 列 出 的 代码 是 随 书 光 瘟 examples/chap12/thumbnail 目 录 中 wxThumbnailCtrl 类 的 事件 处 理 


BEGIN_EVENT_TABLE( wxThumbnailCtrl, wxScrolledWindow ) 
EVT_CHAR(wxThumbnailCtrl: :OnChar ) 

END_EVENT_TABLE( ) 

void wxThumbnailCtr1: :OnChar(wxKeyEvent& event) 


{ 

int flags = 0; 

if (event.ControlDown()) 
flags |= wxTHUMBNAIL_CTRL_DOWN; 

if (event.ShiftDown() ) 
flags |= wxTHUMBNAIL_SHIFT_DOWN; 

if (event.AltDown() ) 
flags |= wxTHUMBNAIL_ALT_DOWN; 

if (event.GetKeyCode() == WXK_LEFT || 
event .GetKeyCode() == WXK_RIGHT | | 
event .GetKeyCode() == WXK_UP || 
event .GetKeyCode() == WXK_DOWN | | 
event .GetKeyCode() == WXK_HOME | | 
event .GetKeyCode() == WXK_PAGEUP | | 
event .GetKeyCode() == WXK_PAGEDOWN | | 
event .GetKeyCode() == WXK_PRIOR | | 
event .GetKeyCode() == WXK_NEXT || 
event .GetKeyCode() == WXK_END) 

{ 
Navigate(event.GetKeyCode(), flags); 

} 

else if (event.GetKeyCode() == WXK_RETURN) 
wxThumbnailEvent cmdEvent( 

wxEVT_COMMAND_THUMBNAIL_RETURN, 
GetId()); 

cmdEvent.SetEventObject(this); 
cmdEvent .SetFlags(flags); 
GetEventHandler()->ProcessEvent(cmdEvent ); 

else 
event.Skip(); 

} 
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更 高 一 级 的 事件 ,这 个 事件 可 以 被 使 用 这 个 类 的 应 用 程序 捕获 并 且 处 理 ,对 于 所 有 其 它 的 按键 , 调 
用 Skip 范 数 以 便 上 应 用 程序 的 其 它 部 分 可 以 继续 人 处理. 


按键 编码 翻译 


键盘 事件 提供 的 是 未 翻译 的 按键 编码 ,而 字符 事件 提供 的 是 翻译 以 后 的 字符 编码 ,对 于 未 翻译 的 
按键 编码 来 说 , 子 母 永远 是 大 些 字符 ,其 它 字 符 则 是 在 WXK_XXX 中 定义 的 字符 .而 对 于 已 经 翻译 
的 按键 编码 来 说 ,字符 的 值 和 同样 的 按键 在 一 个 文本 编辑 框 中 被 按 下 以 后 在 编辑 框 中 产生 的 字 

符 相同 . 


举 个 简单 的 例子 , 当 一 个 单独 的 A 键 按 下 的 时 候 ,在 KEY_DOWN 事 件 中 的 字符 编码 是 大 字 子 母 A 
的 ASCII 码 65, 而 在 相应 的 字符 事件 中 的 字符 编码 是 小 写 的 ASCII 的 a, 编 码 为 97. 换 名 话说 , 当 
Shift 和 A 键 同时 被 按 下 时 ,上 述 两 个 事件 中 的 编码 是 一 样 的 ,都 是 大 写 的 A(65). 


从 这 个 小 例子 中 我 们 可 以 清晰 的 看 到 ,我 们 可 以 从 键 衣 按 下 事件 中 的 键盘 编码 和 Shift 键 状态 计 
算出 相应 的 ASCII 码 ,但 是 通常 来 说 ,如 果 你 希望 义理 的 是 ASCII 码 ,你 应 该 使 用 字符 事件 
EVT_CHAR, 因 为 对 于 非 子 母 按 键 来 说 ,如 何 翻译 是 和 键盘 布局 有 关 的 ,只 有 系统 本 身 才能 对 按 
键 事件 进行 很 好 的 翻译 . 


另外 一 种 自动 完成 的 按键 翻译 是 那 种 带 有 Control 键 的 翻译 :比如 说 Ctrl+A, 在 KeyDown 事 件 中 ， 
字符 编码 仍然 是 A, 但 是 在 字符 事件 中 则 为 ASCII 的 1, 因 为 ASCll 中 定义 这 个 组 合 键 的 编码 为 1. 


如 果 你 对 在 你 的 系统 中 这 种 系统 相关 的 键盘 行为 感 兴趣 ,可 以 编译 和 运行 键 瘟 例 子 程序 (在 
samples/keyboard 目 录 中 ) 然 后 按 每 个 键 试 一 下 . 


修饰 键 变量 


在 windows 平 台 上 ,有 Control 和 Alt 两 个 修饰 键 ,那个 特殊 的 window 键 表现 Meta 键 的 行为 .在 Unix 
平台 上 ,表现 Meta 键 的 按键 是 可 以 配置 的 (通过 运行 xmodmap 来 查看 和 改变 现 有 配置 ). 有 时 
Numlock 键 也 会 被 配置 成 Meta 键 ,这 是 为 什么 在 Numlock 键 被 按 下 时 , 按 下 Meta 键 再 按 下 别 的 键 
的 时 候 ,HasModifiers 却 返回 False 的 原因 . 


在 Mac OSX 平 台 上 ,Command 键 (上 面 有 一 个 茶 果 的 标识 ) 被 翻译 成 Meta 键 ,而 Option 键 被 翻译 
成 Alt 键 . 


各 个 平台 上 修饰 键 的 不 同 如 下 表 所 示 , 其 中 wxWidgets 采 用 的 修饰 键 名 放 在 第 一 栏 ,三 个 主要 平 
台 上 对 应 的 键 放 在 后 面 三 栏 . 


Modifier Key on Windows Key on Unix Key on Mac 
Shift Shift Shift Shift 
Control Control Control Control 
alt 
Alt Alt Alt Option 
option 
Meta Windows (Configurable) Command 


为 在 Mac OSX 上 使 用 Command 键 而 在 别 的 平台 上 使 用 Control 键 ,你 可 以 使 用 wxKeyEvent 的 
CmdDown 画 数 来 判断 这 个 键 在 不 同 的 平台 上 是 否 被 按 下 . 


另外 除了 在 键盘 事件 处 理 函 数 中 判断 一 个 修饰 键 是 否 被 按 下 以 外 ,你 还 可 以 使 用 
wxGetKeyState 辑 数 加 上 对 应 的 键盘 编码 作为 参数 来 判断 某 个 键 是 否 被 按 下 ， 


加 速 键 


加 速 键 是 为 了 实现 通过 某 种 组 合 键 来 快速 执行 菜单 命 合 . 加 速 键 的 处 理 是 在 所 有 的 键 衣 事 件 ( 包 
括 字符 事件 ) 之 后 .标准 的 加 速 键 包括 Ctrlt O 用 来 打开 一 个 文件 ,Ctrl+V 用 来 把 剪贴 板 上 的 数据 粘 
贴 到 应 用 程序 中 等 .最 简单 的 定义 加 速 键 的 方法 是 在 菜单 项 定义 函数 中 使 用 下 面 的 代码 : 


menu->Append(wxID_COPY, wxT("Copy\tCtr1+C") ); 


wxWidgets 把 "\t" 后 面 的 内 容 翻 译 为 加 速 键 增加 到 菜单 的 加 速 键 表 中 .在 上 面 的 例子 中 ,用 户 按 
Ctrl+C 组 合 键 的 效果 和 用 户 选择 这 个 菜单 的 效果 是 完全 一 样 的 . 


你 可 以 使 用 Ctrl,Alt 和 Shift 以 及 它们 的 各 种 组 合 ,然后 加 一 个 + 号 或 者 -号 再 跟 一 个 字符 或 者 功能 
键 ,比如 下 面 的 这 些 加 速 键 都 是 合法 的 加 速 键 : Ctrl+B, G, Shift-Alt-K, F9, Ctrl+F3, Esc 和 Del. 
在 你 的 加 速 键 定 义 中 可 以 使 用 下 面 的 名 字 : Del, Back, Ins, Insert, Enter, Return, PgUp, PgDn, 
Left, Right, Up, Down, Home, End, Space, Tab, Esc 和 Escape. 这 些 命令 是 大 小 写 无 关 的 (你 
想 怎 样 使 用 大 小 写 都 可 以 ). 


注意 在 Mac OSX 平 台 上 ,一 个 定义 为 Ctrl 的 加 速 键 实际 上 代表 的 是 Command 键 . 


另外 一 种 设置 加 速 键 的 方法 是 使 用 wxAcceleratorEntry 对 象 定义 一 个 加 速 键 表 ,然后 使 用 
wxWindow:: SetAcceleratorTable 函 数 将 其 和 某 个 窗口 绑 定 .每 一 个 wxAcceleratorEntry 的 记录 
是 由 一 个 修饰 键 比特 位 值 和 一 个 字符 或 者 功能 键 以 及 一 个 窗口 标识 符 组 成 的 ,如 下 所 示 : 


wxAcceleratorEntry entries[4]; 


entries[0].Set(wxACCEL_CTRL, (int) 'N', WXID_NEW ; 
entries[1].Set(wxACCEL_CTRL, (int) 'X', wxID_EXIT); 
entries[2].Set(wxACCEL_SHIFT, (int) 'A', wxID_ABOUT) ; 


entries[3].Set(wxACCEL_NORMAL, WXK_DELETE, wxID_CUT); 
wxAcceleratorTable accel(4, entries); 
frame->SetAcceleratorTable(accel); 


bay ee 个 加 速 键 表 , 也 可 以 混合 使 用 菜单 项 加 速 键 和 加 速 键 表 , 如 果 你 想 给 一 个 菜单 
项 指定 多 个 加 速 键 ,这 将 是 非常 有 用 的 ,因为 你 不 可 能 在 一 个 菜单 项 中 指定 多 个 加 速 键 . 


6.3 处 理 游戏 手柄 事件 


wxJoystick 类 让 你 可 以 在 windows 平 台 或 者 linux 平 台 上 使 用 一 到 两 个 游戏 手柄 .典型 的 使 用 方 
法 是 ,你 创建 wxJoystick 的 一 个 实例 ,并 且 传 递 给 它 wxJOYSTICK1 或 者 wxJOYSTICK2 的 参数 ， 
并 且 以 全 局 指针 保持 这 个 实例 . 当 你 需要 义理 手柄 事件 的 时 候 , 使 用 SetCapture 函 数 和 一 个 窗口 
指针 作为 参数 ,来 使 的 这 个 窗口 收 到 游戏 手柄 事件 , 当 你 不 需要 使 用 手柄 的 时 候 ,调用 
ReleaseCapture 画 数 移出 手柄 事件 .当然 ,你 完全 可 以 在 点 用 程序 初始 化 的 时 候 调 用 SetCapture 
函数 而 在 应 用 程序 退出 的 时 候 调 用 ReleaseCapture 画 数 ,以 便 在 整个 应 用 程序 生命 周期 内 义 理 
游戏 手柄 事件 . 


在 开始 描述 详细 的 函数 和 事件 之 前 ,让 我 们 先 看 一 下 wxWidgets 的 发 行 版 中 samples/joystick 目 
录 中 的 例子 .在 这 个 例子 中 ,用 户 可 以 使 用 游戏 手柄 上 的 某 个 按钮 画 线 ,并 且 在 按 下 按钮 的 时 候 播 
放 一 个 声音 片断 . 


下 面 大 概 列 出 了 应 用 程序 的 起 始 代码 ,首先 ,点 用 程序 通过 创建 一 个 临时 的 游戏 手柄 对 象 来 检查 
系统 是 否 有 安装 手柄 ,如 果 没 有 则 退出 应 用 程序 .然后 装载 声音 文件 ,并 且 获 取 手 柄 的 最 大 活动 范 
围 以 便 在 窗口 上 画 画 的 时 候 实现 合理 的 缩放 使 得 画 画 的 区 域 充满 整个 绘画 窗口 . 


#include "wx/wx.h" 
#include "wx/sound.h" 
#include "wx/joystick.h" 
bool MyApp: :OnInit() 

{ 


wxJoystick stick(wxJOYSTICK1); 
if (!stick.IsOk()) 


wxMessageBox(wxT("No joystick detected!")); 
return false; 


m_fire.Create(wxT("buttonpress.wav")); 
m_minX = stick.GetXMin(); 

m_minY = stick.GetYMin(); 

m_maxX = stick.GetXMax(); 

m_maxY = stick.GetYMax(); 

// Create the main frame window 


return true; 


MyCanvas 是 那个 用 来 接收 和 义理 手柄 事件 的 窗口 ,下 面 的 MyCanvas 类 的 实现 部 分 : 


BEGIN_EVENT_TABLE(MyCanvas, wxScrolledwindow) 
EVT_JOYSTICK_EVENTS(MyCanvas: :OnJoystickEvent ) 
END_EVENT_TABLE( ) 
MyCanvas: :MyCanvas(wxWindow *parent, const wxPoint& pos, 
const wxSize& size): 
wxScrolledWindow(parent, wxID_ANY, pos, size, wxSUNKEN_BORDER) 


{ 
m_stick = new wxJoystick(wxJOYSTICK1) ; 
m_stick->SetCapture(this, 10); 

} 

MyCanvas: :~MyCanvas() 

{ 


m_stick->ReleaseCapture(); 
delete m_stick; 


void MyCanvas: :OnJoystickEvent (wxJoystickEvent& event) 
{ 
static long xpos = -1; 
static long ypos = -1; 
wxClientDC dc(this); 
wxPoint pt(event.GetPosition()); 
// if negative positions are possible then shift everything up 
int xmin = wxGetApp().m_minx; 
int xmax = wxGetApp().m_maxx; 
int ymin = wxGetApp().m_minyY; 
int ymax = wxGetApp().m_maxyY; 
if (xmin &lt; 0) { 
xmax += abs(xmin); 
pt.x += abs(xmin); 


} 
if (ymin &lt; 0) { 
ymax += abs(ymin); 
pt.y += abs(ymin); 
} 
// Scale to canvas size 
int cw, ch; 
GetSize(&cw, &ch); 
pt.x = (long) (((double)pt.x/(double)xmax) * cw); 
pt.y = (long) (((double)pt.y/(double)ymax) * ch); 
if (xpos &gt; -1 && ypos &gt; -1 && event.IsMove() && event.ButtonIsDown() ) 
{ 
dc.SetPen( *wxBLACK_PEN); 
dc.DrawLine(xpos, ypos, pt.x, pt.y); 
} 
xpos = pt.x; 
ypos pt.y; 
wxString buf; 
if (event .ButtonDown() ) 
buf .Printf(wxT("Joystick (%d, %d) Fire!"), pt.x, pt.y); 
else 
buf .Printf(wxT("Joystick (%d, %d)"), pt.x, pt.y); 
frame->SetStatusText (buf); 
if (event.ButtonDown() && wxGetApp().m_fire.IsOk()) 


wxGetApp().m_fire.Play(); 


wxJoystick 的 事件 


WXJoystick 类 产生 wxJoystickEvent 类 型 的 事件 ,下 表 列 出 了 所 有 相关 的 事件 映射 宏 : 


FASE &i2wxEVT_JOY_ BUTTON _ DOWN 事件 ,手柄 
上 的 某 个 按钮 被 按 下 的 时 候 产生 . 


Hk% FBwxEVT_JOY_BUTTON _UP 事 件 , 某 个 按钮 


EVT_JOY_BUTTON(func) 


EVT_JOY_BUTTON(func) 


被 释放 的 时 候 产 生 . 
5 Wa 
EVT JOY MOVE(func) fae See aoe MOVE 事 件 ,手柄 在 X-Y 平 面 
EVT_JOY_ZMOVE(func) SAMO A 


EVT_JOYSTICK_EVENTS(func) ”处 理 所 有 的 手柄 事件 . 


wxJoystickEventhJ a A EX 


下 面 列 出 了 所 有 wxJoystickEvent 的 成 员 函 数 ,你 可 以 使 用 它们 获取 关于 手柄 事件 更 详细 的 信息 ， 


你 你 正在 处 理 哪 种 类 型 的 手柄 事件 . 


调用 ButtonDown 画 数 来 检测 是 否 是 按钮 被 按 下 事件 ,你 可 以 传递 可 选 的 wxJOY_BUTTONnn 
代表 1,2,3 或 4) 来 测试 是 否 某 个 特定 的 按钮 正 被 按 下 ,或 者 使 用 wxJOY_BUTTON_ANY 如 果 你 不 
关心 具体 是 哪个 按钮 被 按 下 的 话 .ButtonUp 则 用 相似 的 方法 来 检测 是 按钮 被 释放 事件 .而 
lsButton 则 相当 于 调用 ButtonDown() || ButtonUp(). 


要 判断 是 否 某 个 按钮 被 按 下 的 状态 而 不 是 事件 本 身 ,你 可 以 使 用 ButtonlsDown 郴 数 , 它 和 
ButtonDown 的 参数 相似 .或 者 你 可 以 直接 使 用 GetButtonState 函 数 和 类 似 的 参数 来 返回 指定 按 
钮 的 按 下 状态 的 比特 位 . 


使 用 IsMove 画 数 来 判断 是 否 是 一 个 XY 平 面 的 移动 事件 ,使 用 IsZMove 判 断 是 否 是 一 个 Z 平 面 的 
移动 事件 . 


GetPosition 返 回 游戏 手柄 当前 XY 平 面 的 座 标 ,而 GetZPosition 返 回 Z 方 向 的 深度 值 (当然 ,如 果 手 
HAZ FF AIS). 


最 后 ,你 可 以 使 用 GetJoystick 来 判断 这 个 事件 是 哪个 手柄 (wxJOYSTICK1 还 是 wxJOYSTICK2) 
产生 的 . 


wxJoystickAx A EEX 


我 们 没有 列 出 游戏 手柄 类 所 有 的 成 员 画 数 ,你 可 以 参考 WxWidgets 的 手册 ,不 过 下 面 是 其 中 最 有 
趣 的 几 个 : 


正 象 我 们 在 前 面 的 例子 中 看 到 的 那样 ,SetCapture 画 数 需要 被 调用 如 果 你 想 让 某 个 窗口 多 理 手 
柄 事件 ,而 一 个 匹配 的 ReleaseCapture 函 数 调 用 用 来 释放 这 次 捕获 ,以 便 允 许 别 的 应 用 程序 使 
用 手柄 .为 避免 别 的 程序 正在 使 用 手柄 ,或 者 手柄 不 能 正常 工作 ,你 应 该 在 调用 SetCapture 之 前 先 
调用 lIsOK 画 数 来 判断 手柄 的 状态 .你 还 可 以 通过 这 些 函 数 来 获取 手柄 的 能 

集 :GetNumberButtons, GetNumberJoysticks,GetNumberAxes,HasRudder 等 等 . 


GetPosition 辑 数 和 GetButtonState 函 数 可 以 让 你 在 手柄 事件 处 理 函 数 以 外 的 地 方 获取 手柄 的 
状态 . 

你 的 应 用 程序 还 可 能 需要 调用 GetXMin,GetXMax 等 这 些 类 似 的 函数 来 判断 一 个 手柄 支持 的 范 
围 . 


第 六 草 小 结 


在 这 一 章 里 ,我 们 介绍 了 怎样 处 理 来 自 鼠 标 , 键 瘟 以 及 游戏 手柄 的 输入 事件 ,现在 你 可 以 给 你 的 应 
用 程序 增加 复杂 的 交互 性 代码 了 .你 可 以 参考 WxWidgets 自 带 的 例子 比如 : samples/keyboard, 
samples/joytest 和 samples/dragimag, 也 可 以 参考 光 瘟 上 的 examples/chap12 目 录 里 的 
wxThumbnailCtrl 类 来 了 解 更 具体 的 信息 . 


在 接 下 来 的 一 章 里 ,我 们 会 介绍 一 下 怎样 对 窗口 里 的 控件 进行 可 变 大 小 的 ,轻便 的 ,可 以 友善 转换 
的 布局 .之 所 以 能 支持 这 些 诱 人 的 特性 ,是 因为 我 们 有 强大 而 灵活 的 布局 控件 . 


第 七 章 使 用 布局 控件 进行 窗口 布局 


所 有 的 图 形 界面 设计 者 都 会 告诉 你 ,人 们 对 于 可 以 看 见 的 对 象 的 排列 是 非常 敏感 的 .一 个 好 的 
GUI 设计 框架 一 定 要 允许 创建 具有 吸引 力 的 窗口 布局 .但 是 和 打印 布局 不 同 ,应 用 程序 的 窗口 可 
能 由 于 大 小 ,字体 设置 甚至 是 语言 的 不 同 进 行 不 同 的 变化 .对 于 一 个 平台 无 关 的 设计 来 说 ,还 要 考 
虑 同一 个 控件 在 不 同 的 平台 上 可 能 有 不 同 的 外 观 和 尺寸 .这 意味 着 使 用 绝对 大 小 和 位 置 来 进行 
窗口 布局 几乎 是 行 不 通 的 .本 章 描述 的 wxWidgets 的 布局 控件 ,让 你 可 以 灵活 的 进行 非常 复 杀 的 
窗口 布局 .如 果 这 听 上 去 有 一 点 让 人 蝴 惧 ,那么 记 住 有 一 些 工 具 可 以 帮助 你 以 图 形 化 的 方式 使 用 
布局 控件 创建 布局 ,比如 包含 在 附 赠 光盘 中 的 DialogBlocks 工具 ,使 用 它们 你 几乎 用 不 着 手动 设 
置 任何 布局 . 


7.1 窗口 布局 基础 


在 深入 介绍 窗口 布局 之 前 ,我 们 先 来 大 概 了 解 一 下 什么 时 候 你 需要 进行 窗口 布局 以 及 你 拥有 的 
几 种 选择 . 


一 个 最 简单 的 情况 是 你 拥有 一 个 frame 窗 口 ,其 中 只 有 一 个 客户 窗口 位 于 这 个 frame 的 客户 区 .这 
是 最 简单 的 情况 ,wxWidgets 将 为 你 完成 所 有 的 布局 工作 ,将 那个 客 户 区 窗口 缩放 到 刚好 适合 
frame 的 客户 区 的 大 小 .wxWidgets 也 会 管理 frame 的 菜单 条 ,工具 条 和 状态 条 (如 果 有 的 话 ). 当 然 ， 
如 果 你 想 使 用 两 个 工具 条 ,你 至 少 要 管理 其 中 的 一 条 ,而 如 果 frame 窗 口 的 客户 区 拥有 超过 一 个 
窗口 ,你 将 不 得 不 自己 单独 管理 它们 所 有 的 大 小 和 位 置 ,比如 你 可 能 需要 在 OnSize 事 件 中 计算 每 
一 个 窗口 的 大 小 并 且 设 置 它们 的 新 位 置 .当然 ,你 也 可 以 使 用 窗口 布局 控件 .类 似 的 ,如 果 你 创建 
了 一 个 定制 的 控件 ,这 个 控件 拥有 多 个 子 窗口 ,你 也 需要 安排 这 些 子 窗口 的 布局 以 便当 你 的 这 个 
控件 被 别人 使 用 而 且 默 认 大 小 改变 的 时 候 , 对 那些 子 窗口 进行 合理 的 布局 


另外 ,大 多 数 应 用 程序 都 需要 创建 自己 的 对 话 框 ,有 时 候 有 些 程序 会 创建 很 多 个 定制 的 对 话 框 ,这 
些 对 话 框 可 能 被 改变 大 小 ,在 这 种 情况 下 ,对 话 框 上 所 有 的 控件 的 大 小 也 应 该 发 生 相应 的 改变 ,以 
便 即 使 这 个 对 话 框 已 经 比 最 初 设计 的 时 候 大 了 很 多 ,这 些 控件 看 上 去 也 不 会 显得 很 奇怪 .另外 应 
用 程序 的 语言 也 可 能 改变 , 某 些 在 默认 语言 中 很 短 的 标签 ,在 另外 一 种 语言 中 可 能 会 变 得 很 长 .如 
果 你 的 应 用 程序 要 应 付 成 百 上 千 中 这 种 对 话 框 ,相信 和 即使 使 用 窗口 布局 控件 ,维护 它们 也 是 一 个 
邻 人 望 而 生 轩 的 工作 ,还 好 幸运 的 是 我 们 还 可 以 使 用 一 些 工 具 让 所 有 这 些 事情 变 得 不 那么 恐怖 


如 果 你 选择 使 用 布局 控件 ,你 需要 自己 决定 怎样 创建 和 发 布 它们 .你 可 以 自己 写 或 者 使 用 工具 来 
创建 C++ 或 者 其 它 语言 的 代码 ,或 者 你 可 以 直接 使 用 XRC 文 件 ,XRC 文 件 用 来 将 布局 的 定义 保存 
在 一 个 Xml 文件 中 ,可 以 被 应 用 程序 动态 加 载 , 也 可 以 通过 wxrc 工 具 将 其 编译 成 C++ 源 文件 以 便 
和 别 的 源 文件 编译 成 一 个 单独 的 可 执行 文件 .大 多 数 的 wxWidgets 对 话 框 编辑 器 都 既 支 持 产 生 
C++ 的 代码 ,又 支持 生成 XRC 文 件 .怎样 作 决 定 完 全 取决 于 你 自己 的 审美 观 , 有 些 人 喜欢 把 一 切 都 
放 在 一 个 C++ 代码 中 以 保持 足够 的 灵活 性 ,而 另外 一 些 人 则 喜欢 把 实现 功能 的 代码 和 产生 界面 
的 代码 分 开 . 


接 下 来 的 小 节 用 来 描述 布局 控件 的 原理 ,再 往 后 一 个 小 节 则 用 来 描述 怎样 使 用 各 种 具体 的 布局 
控件 来 编程 . 


2 窗口 布局 控件 


wxWidgets 使 用 的 窗口 布局 控件 的 算法 和 其 它 GUI 程 序 开发 框架 的 算法 ,例如 Java 的 
AWTGTK+ 以 及 Qt 等 是 非常 相似 的 .它们 都 是 基于 这 样 的 一 个 假设 , 那 就 是 每 一 个 窗口 可 以 报告 
它们 自己 需要 的 最 小 尺寸 以 及 当 P A a a 通常 这 
也 意味 着 程序 代码 中 没有 给 对 话 框 中 的 控件 设 定 固定 的 大 小 ,取而代之 的 是 设置 了 一 个 窗口 布 
局 控件 ,这 个 窗口 布局 控件 会 被 寻 问 它 最 需要 的 合适 大 小 ,而 窗口 布局 控件 则 会 一 问 它 内 部 
的 那些 窗口 ,空白 区 域 ,控件 以 及 其 它 的 窗口 布局 控件 最 合适 的 大 小 ,以 此 类 推 .要 注意 布局 控件 
并 非 是 wxWindow 的 派生 类 ,因此 不 具有 TAB 顺序 ,所 需要 的 系统 开销 也 比 一 个 真实 的 窗口 要 小 
的 多 .布局 控件 建立 的 是 一 种 包含 继承 关系 ,在 一 个 复杂 的 对 话 框 里 ,这 种 包含 继承 关系 的 层级 可 
能 会 很 深 ,但 是 所 有 这 些 布局 控件 中 的 窗口 或 控件 在 窗口 继承 关系 中 可 能 都 是 兄弟 控件 ,它们 都 
以 这 个 对 话 框 作为 自己 的 父 窗 口 


在 对 话 框 编辑 软件 中 ,布局 控件 的 包含 继承 关系 以 一 种 更 直观 的 图 形 化 方式 表示 .下 图 演示 了 
Anthemion 软 件 公司 的 DialogBlocks 软 件 编辑 一 个 个 人 对 话 框 时 候 的 样子 ,这 个 对 话 框 我 们 会 
在 第 9 章 ," 创 建 自 己 的 对 话 框 " 中 作为 一 个 例子 .一 个 红色 的 方 框 围绕 在 当前 选择 的 控件 上 ,而 蓝 
色 的 方 框 则 用 来 指示 其 直接 父 容器 的 范围 ,左边 显示 的 是 对 话 框 的 容器 继承 关系 树 ,当然 所 有 这 
些 控 件 还 是 有 它们 自己 的 窗口 继承 关系 的 ,正如 我 们 前 面 提 到 的 那 祥 ,窗口 继承 关系 树 和 容器 继 
承 关 系 树 有 很 大 的 区 别 . 
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为 了 更 清楚 的 说 明 容 器 继承 关系 和 窗口 继承 关系 的 不 同 ,我 们 用 下 图 来 大 概 的 表示 上 图 中 的 容 
器 继承 关系 .下 图 中 ,阴影 部 分 代表 实际 的 窗口 ， pe 可 以 看 出 ,对 话 框 首 
先 使 用 了 两 个 垂直 布局 控件 ,以 便 在 对 话 框 周围 释放 出 一 个 合理 的 边界 区 域 ,里 面 的 那个 垂直 布 
局 控件 中 有 两 个 水 平 布局 控件 和 一 些 其 它 的 控件 ,其 中 一 Pep 截 空 白 
区 域 以 便 使 得 其 中 一 个 控件 远离 同 组 中 另外 的 控件 . 正 象 你 看 到 的 那样 ,使 用 布局 控件 就 象 使 用 
一 堆 大 小 不 等 的 硬 纸 片 进行 摆 放 ,然后 把 各 个 窗口 控件 放置 到 硬 纸 片 的 合适 的 位 置 .当然 这 个 比 
喻 并 不 完全 贴切 因为 , 硬 纸 片 的 大 小 是 不 会 伸缩 的 . 
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目前 为 止 wxWidgets 总 共 支 持 五 类 布局 控件 ,每 一 中 布局 控件 或 者 用 来 实现 一 种 特殊 的 布局 方 
式 ,或 者 用 来 实现 和 布局 相关 的 一 种 特殊 的 功能 比如 在 某 些 控件 周围 围绕 一 个 静态 的 文本 框 . 接 
下 来 的 小 节 我 们 会 对 它们 进行 一 一 的 介绍 . 


布局 控件 的 通用 特性 


所 有 的 布局 控件 都 是 容器 ,这 就 是 说 ,它们 都 是 用 来 容纳 一 个 或 多 个 别 的 窗口 或 者 元 素 的 ,不 论 每 
个 单独 的 布局 控件 怎样 排放 它们 的 子 元 素 ,所 有 的 子 元 素 都 必然 有 下 面 这 些 通 用 的 特性 . 


最 小 大 小 : 布局 控件 中 的 每 个 元 素 都 有 计算 自己 的 最 小 大 小 的 能 力 (这 往往 是 通过 每 个 元 素 的 
DoGetBestSize 函 数 计算 出 来 的 ). 这 是 这 个 元 素 的 自然 大 小 .举例 来 说 ,一 个 复 选 框 的 自然 大 小 


定 固 定 的 大 小 ,并 且 在 把 它 增 加 到 布局 控件 中 时 指定 wxFIXED_MINSIZE 以 改变 自动 计算 的 最 
小 大 小 .需要 注意 的 是 ,不 是 每 个 控件 都 可 以 计算 自己 的 大 小 ,对 于 类 似 列表 框 这 样 的 控件 来 说 ， 
你 必须 清晰 的 指明 它 的 大 小 ,因为 它们 没有 自然 大 小 .另外 一 些 控件 则 只 拥有 自然 高 度 不 拥有 自 
然 宽度 ,比如 一 个 单行 的 文本 框 .下 图 演示 了 当 对 话 框 中 只 有 一 个 控件 的 时 候 , 以 上 三 种 控件 怎样 
扩展 对 话 框 以 适合 自己 的 最 小 大 小 . 








边界 : 每 个 元 素 都 应 该 有 一 个 边界 .所 谓 边界 指 的 是 用 来 和 别 的 元 素 分 开 的 空白 区 域 ,边界 的 最 
小 大 小 必须 被 显 式 的 指定 ,一 般 设 置 为 5 个 象 素 .下 图 演示 了 对 话 框 只 有 一 个 按钮 控件 但 是 指定 
了 0,5 和 10 作 为 最 小 边界 值 的 时 候 的 样子 . 





对 章 方式 : 每 个 元 素 都 可 以 被 以 居中 或 者 对 齐 某 个 边 的 方式 放置 .下 图 演示 了 一 个 水 平 的 布局 控 
件 ,在 其 中 增加 了 一 个 列表 框 ,一 个 和 三 个 按钮 ,其 中 第 一 个 按钮 以 居中 方式 增加 ,第 二 个 则 为 上 
对 齐 ,第 三 个 则 为 下 对 齐 方式 .对 齐 既 可 以 是 水 平方 向 的 也 可 以 是 垂直 方向 的 ,但 是 对 于 大 多 数 布 
局 控件 来 说 ,只 有 一 个 方向 是 有 效 的 .比如 对 于 水 平 布局 控件 来 说 ,只 有 垂直 方向 是 有 效 的 ,因为 
水 平方 向 的 空间 是 被 所 有 的 子 元 素 分 割 的 ,因此 设置 水 平 对 齐 方式 是 没有 意义 的 (当然 ,为 了 达到 
水 平 对 齐 的 效果 ,我 们 可 能 需要 插入 一 个 水 平方 向 的 空白 区 域 ,关于 这 点 我 们 不 作 太 多 的 说 明 ). 


Alignment 


Top-aligned 





Battom-aligned 


伸缩 因子 : 如 果 一 个 布局 控件 的 空间 大 于 它 所 有 子 元 素 所 需要 的 空间 ,那么 我 们 需要 一 个 机 制 来 
分 割 多 余 的 空间 .为 了 实现 这 个 目的 ,布局 控件 中 的 每 一 个 元 素 都 可 以 指定 一 个 伸缩 因子 ,如 果 这 
个 因子 设置 为 默认 值 0, 那 么 子 元 素 将 保持 其 原本 的 大 小 ,大 于 0 的 值 用 来 指定 这 个 子 元 素 可 以 分 
割 的 多 余 空 间 的 比例 ,因此 如 果 两 个 子 元 素 的 伸缩 因子 为 1, 其 它 子 元 素 的 伸缩 机 制 为 0, 那 么 这 
两 个 子 元 素 将 会 各 占用 多 余 空间 的 50% 的 大 小 ,下 图 演示 了 一 个 对 话 框 有 三 个 按钮 它们 的 初始 
大 小 和 其 中 一 个 的 伸缩 因子 设 为 1 以 后 各 自 的 大 小 . 


Stretch Jest 





注意 在 wxWidgets 的 手册 中 ,有 时 不 使 用 伸缩 因子 (stretch factor) 这 
这 个 词 表 示 相 同 的 含义 . 





个 词 ,而 用 比例 (proportion) 


7.3 使 用 布局 控件 进行 编程 


现在 我 们 开始 使 用 布局 控件 进行 窗口 布局 ,首先 ,创建 一 个 顶层 的 布局 控件 (任何 类 型 的 布局 控件 
都 可 以 ), 使 用 wxWindow::SetSizer 函 数 闻 它 和 你 的 顶层 窗口 绑 定 .现在 你 可 以 在 这 个 顶层 布局 
控件 中 放置 你 的 窗口 或 者 其 它 控件 元 素 了 .如 果 你 想 让 你 的 顶层 窗口 的 大 小 适合 所 有 控件 所 需 
要 的 大 小 ,你 可 以 调用 wxSizer:Fit 函 数 ,将 那个 顶层 窗口 的 指针 作为 其 参数 . 想 要 顶层 窗口 在 以 
后 的 执行 过 程 中 尺寸 永远 不 小 于 初始 尺寸 ,可 以 使 用 wxSizer:: SetSizeHints 函 数 , 将 顶层 窗口 的 
指针 作为 参数 ,这 闻 使 得 wxWindow::SetSizeHints 画 数 以 合适 的 参数 被 调用 . 


除了 使 用 上 面 介 绍 的 方法 依次 调用 三 个 画 数 以 外 ,你 还 可 以 直接 通过 调用 
wxWindow::SetSizerAndFit 函 数 来 达到 同样 的 效果 ,这 会 使 得 上 面 的 三 个 画 数 依次 被 调用 . 


如 果 在 你 的 frame 窗 口 里 使 用 了 panel, 你 可 能 不 知道 到 底 该 给 frame 还 是 panel 指 定 布局 控件 .这 
个 问题 应 该 这 样 看 ,如 果 你 的 frame 窗 口中 只 有 一 个 panel, 所 有 其 它 的 窗口 和 控件 都 是 panel 的 
子 窗口 ,那么 wxWidgets 已 经 知道 怎样 将 这 个 panel 以 合适 的 大 小 和 位 置 放置 在 frame 上 了 ,因此 
你 只 需要 给 panel 绑 定 一 个 布局 控件 ,以 便 其 可 以 对 所 有 panel 的 子 窗口 进行 布局 .而 如 果 你 的 
frame 窗 口中 有 多 个 panel, 那 么 首先 你 不 得 不 为 ffame 绑 定 一 个 布局 控件 以 便 对 panel 进 行 布局 ， 
然后 针对 每 个 panel 还 应 该 绑 定 一 个 布局 控件 ,以 便 对 panel 中 的 子 窗口 进行 布局 . 


接 下 来 的 小 节 里 ,我 们 来 依次 描述 一 下 每 一 种 布局 控件 类 型 以 及 使 用 它们 的 方法 : 
使 用 wxBoxSizer 进 行 编程 


WXBoxSizer 可 以 将 它 的 容器 子 元 素 进行 横向 或 者 纵向 的 排列 (具体 的 排列 方式 在 构造 画 数 中 指 

定 ). 如 果 采 用 横向 排列 的 方法 , 则 子 元 素 在 纵向 上 可 以 指定 居中 ,顶部 对 齐 ,底部 对 齐 , 如 果 采 用 纵 
向 排列 的 方法 , 子 元 素 在 横向 上 可 以 指定 居中 , 左 对 齐 或 者 右 对 齐 的 方式 .前 一 小 节 提 到 过 的 缩放 
因子 用 来 指示 在 主要 方向 上 的 缩放 ,比如 对 于 横向 排列 来 说 ,缩放 因子 指 的 就 是 在 横向 上 子 元 素 

的 缩放 比例. 下 图 演示 了 上 一 小 节 最 后 一 幅 图 采用 纵向 排列 的 样子 . 


Stretch Test 区 | 





你 可 以 使 用 wxBoxSizer 的 Add 方 法 增加 一 个 子 元 素 : 


// 增加 一 个 窗口 

void Add(wxwindow* window, int stretch = 0, int flags = 0, 
int border = 0); 

// 增加 一 个 布局 控件 

void Add(wxSizer* window, int stretch = 0, int flags = 0, 
int border = 0); 


第 一 个 参数 是 要 增加 的 窗口 或 者 布局 控件 的 指针 
第 二 个 参数 是 前 面 说 过 的 缩放 因子 


第 三 个 参数 是 一 个 比特 位 列表 ,用 来 指示 新 增 的 子 元 素 的 对 齐 和 边界 的 行为 .对 齐 比 特 位 用 来 指 
示 当 垂直 排列 的 布局 控件 的 宽度 发 生 改 变 时 子 元 素 的 水 平 对 齐 方式 ,或 者 是 水 平 排列 的 布局 控 
件 的 高 度 改 变 时 子 元 素 的 垂直 对 齐 方式 ,默认 的 值 为 WxXALIGN_LEFT | wxALIGN_TOP, 可 选 的 
值 列举 在 下 表 中 : 


0 
wxGROW 


wxSHAPED 

wxALIGN_LEFT 

wxALIGN_RIGHT 

wxALIGN_TOP 
wxALIGN_BOTTOM 
wxALIGN_CENTER_HORIZONTAL 
WXALIGN_CENTER_VERTICAL 


WXALIGN_CENTER 


wxLEFT 
wxRIGHT 
wxTOP 
wxBOTTOM 


wxALL 


第 四 个 参数 指定 边界 间隔 的 大 小 


当然 你 也 可 以 直接 增加 一 段 空白 ,下 面 演示 


子 元 素 保留 原始 大 小 . 


子 元素 随 这 布局 控件 一 起 改变 大 小 . 等 同 于 
wxEXPAND. 


子 元素 保 持原 有 比例 按 缩放 因子 缩放 . 
左 对 齐 . 

右 对 齐 . 

顶端 对 齐 . 

底部 对 齐 . 

水 平 居 中 . 

垂直 居中 . 


水 平 或 者 垂直 居中 . 
wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL. 


边界 间隔 位 于 子 元 素 左 面 . 
边界 间隔 位 于 子 元 素 右 面 . 
边界 间隔 位 于 子 元 素 上 面 . 
边界 间隔 位 于 子 元 素 下 面 . 


边界 间隔 位 于 子 元 素 四 周 .wxLEFT | wxRIGHT | 
wxTOP | wxBOTTOM. 





了 增加 空白 区 域 的 几 种 方法 : 


// 增加 一 段 空 白 ( 旧 方法 ) 

void Add(int width, int height, int stretch = 0, int flags = 0, 
int border = 0); 

// 增加 一 段 固定 大 小 的 空白 

void AddSpacer(int size); 

// 增加 一 个 可 缩放 的 空白 

void AddStretchSpacer(int stretch = 1); 


上 面 第 二 种 方法 相当 于 调用 Add(size, size, 0), 第 三 种 则 相当 于 调用 Add(0, 0, stretch). 


我 们 来 举 这 样 一 个 例子 ,一 个 对 话 框 包含 一 个 多 行文 本 框 和 两 个 位 于 底 端的 按钮 .我 们 可 以 以 这 
样 的 角度 去 看 待 这 些 窗口 ,首先 是 一 个 顶层 的 垂直 布局 ,包含 一 个 多 行文 本 框 和 一 个 底层 的 子 布 
局 控件 ,这 个 子 布局 控件 是 一 个 水 平 的 布局 控件 , 它 包 含 一 个 OK 按钮 ,被 放置 在 左面 ,和 一 个 
Cancel 按 钮 ,被 放置 在 右面 . 当 对 话 框 的 大 小 发 生变 化 的 时 候 , 我 们 希望 多 行文 本 框 随 着 对 话 框 
大 小 的 变化 而 变化 ,而 按钮 则 保持 它们 原来 的 大 小 ,并 且 在 水 平方 向 上 居中 排列 ,如 下 图 所 示 : 


Sizer Dialog 


[M y text] 





下 面 列 出 了 实现 上 述 对 话 框 所 使 用 的 代码 : 


MyDialog: :MyDialog(wxWindow *parent, wxWindowID id, 
const wxString &title ) 
wxDialog(parent, id, title, 
wxDefaultPosition, wxDefaultSize, 
wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER) 


wxBoxSizer *topSizer = new wxBoxSizer( wxVERTICAL ); 
// 创建 一 个 最 小 大 小 为 100x608 S17 LATE 
topSizer->Add( 

new wxTextCtr1( this, wxID_ANY, "My text.", 

wxDefaultPosition, wxSize(100,60), wxTE_MULTILINE), 

1, // 垂直 方向 可 缩放 , 缩放 因子 为 1 

WXEXPAND| // 水 平方 向 可 缩放 

wxALL, // 四 周 都 由 空白 边框 

10 ); // 空白 边框 大 小 为 10 
wxBoxSizer *buttonSizer = new wxBoxSizer( wxHORIZONTAL ); 
buttonSizer ->Add( 

new wxButton( this, wxID_OK, "OK" ), 

0, // 水 平方 向 不 可 缩放 

wxALL, // 四 周 有 空 白 边 框 : (注意 默认 为 顶部 对 齐 ) 

10 ); // 空白 边框 大 小 为 19 
buttonSizer ->Add( 

new wxButton( this, wxID_CANCEL, "Cancel" ), 

0, // 水 平方 向 不 可 缩放 

WXALL, // 四 周 有 空 白 边 框 : (注意 默认 为 顶部 对 齐 ) 

10 ); // 空白 边框 大 小 为 19 
topSizer->Add( 

buttonSizer, 

0, // 垂直 方向 不 可 缩放 

wWXALIGN_CENTER ); // 无 边框 并 且 居 中 对 齐 
SetSizer( topSizer ); // 绑 定 对 话 框 和 布局 控件 
topSizer->Fit( this ); // 调用 对 话 框 大 小 
topSizer->SetSizeHints( this ); // 设置 对 话 框 最 小 大 小 


使 用 wxStaticBoxSizer 编 程 


wxStaticBoxSizer 是 一 个 继承 自 wxBoxSizer 的 布局 控件 ,除了 实现 wxBoxSizer 的 功能 ,另外 还 在 
整个 布局 的 范围 以 外 增加 了 一 个 静态 的 边框 wxStaticBox, 这 个 wxStaticBox 需 要 手动 创建 并 且 
在 wxStaticBoxSizer 的 构造 画 数 中 作为 参数 传 入 ,Add 辑 数 和 wxBoxSizer 的 Add 函 数 用 法 相同 . 


下 图 演示 了 使 用 wxStaticBoxSizer 对 一 个 复 选 框 进行 布局 的 样子 : 


Static box sizer dialog (x) 


General settings 





对 应 的 代码 : 


MyDialog: :MyDialog(wxWindow *parent, wxWindowID id, 
const wxString &title ) 
: wxDialog(parent, id, title, 
wxDefaultPosition, wxDefaultSize, 
wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER) 


{ 
// 创建 一 个 顶层 布局 控件 
wxBoxSizer* topLevel = new wxBoxSizer(wxVERTICAL) ; 
// 创建 静态 文本 框 和 静态 文本 框 布局 控件 
wxStaticBox* staticBox = new wxStaticBox(this, 
wxID_ANY, wxT("General settings")); 
wxStaticBoxSizer* staticSizer = new wxStaticBoxSizer(staticBox, 
WXVERTICAL ) ; 
topLevel->Add(staticSizer, 0, 
wxALIGN_CENTER_HORIZONTAL|wxALL, 5); 
// 在 其 中 增加 一 个 复 选 框 
wxCheckBox* checkBox = new wxCheckBox( this, ID_CHECKBOX, 
wxT("&Show splash screen"), wxDefaultPosition, wxDefaultSize) ; 
staticSizer->Add(checkBox, ©, wxALIGN_LEFT |wxALL, 5); 
SetSizer(topLevel); 
topLevel->Fit(this); 
topLevel->SetSizeHints(this); 
} 
使 用 wxGridSizer 编 程 


wxGridSizer 布 局 控件 可 以 以 二 维 表 的 方式 排列 它 的 子 元 素 ,这 个 二 维 表 的 每 个 表格 的 大 小 都 是 
相同 的 ,都 等 于 最 长 的 那个 表格 的 长 度 和 最 高 的 那个 表格 的 高 度 .创建 一 个 wxGridSizer 需 要 指 
定 它 的 行 数 和 列 数 ,以 及 一 个 额外 的 行 间距 和 列 间 距 .Add 方 法 和 wxBoxSizer 的 用 法 相同 . 

下 图 演示 了 一 个 两 行 三 列 的 网 格 布局 控件 ,由 于 有 一 个 很 大 的 按钮 ,导致 这 个 格 的 大 小 很 大 ,从 而 
导致 所 有 的 表格 的 大 小 都 跟着 变 大 : 


Flex grid sizer dialog 


Two [the second button) 





代码 如 下 : 


MyDialog: :MyDialog(wxWindow *parent, wxWindowID id, 
const wxString &title ) 
: wxDialog(parent, id, title, 
wxDefaultPosition, wxDefaultSize, 
wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER) 


// 创建 一 个 顶层 网 格 布局 控件 
wxGridSizer* gridSizer = new wxGridSizer(2, 3, 0, 0); 
SetSizer(gridSizer ); 
wxButton* button1 = new wxButton(this, ID_BUTTON1, wxT("One")); 
gridSizer->Add(button1, ©, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 
wxButton* button2 = new wxButton(this, ID_BUTTON2, wxT("Two (the second button)")); 
gridSizer->Add(button2, 0, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 
wxButton* button3 = new wxButton(this, ID_BUTTON3, wxT("Three")); 
gridSizer->Add(button3, ©, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 
wxButton* button4 = new wxButton(this, ID_BUTTON4, wxT("Four")); 
gridSizer->Add(button4, 0, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 
wxButton* button5 = new wxButton(this, ID_BUTTON5, wxT("Five")); 
gridSizer->Add(button5, 0, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 
wxButton* button6 = new wxButton(this, ID_BUTTON6, wxT("Six")); 
gridSizer->Add(button6, ©, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 
gridSizer->Fit(this); 
gridSizer->SetSizeHints(this) ; 


al 加 2] 
使 用 wxFlexGridSizer 编 程 

wxFlexGridSizer 同 样 采用 二 维 表 来 对 其 子 元 素 进行 布局 ,和 wxGridSizer 不 同 的 是 , 它 不 要 求 所 
有 的 表格 的 大 小 都 是 一 样 的 ,只 要 求 同 一 列 上 所 有 表格 的 宽度 是 相同 的 并 且 同 一 行 上 所 有 表格 
的 高 度 是 相同 的 ,也 就 是 说 , 行 的 高 度 或 者 列 的 宽度 仅 由 这 一 行 或 者 这 一 列 上 的 子 元 素 决 定 .另外 
还 可 以 给 行 和 列 指定 是 否 缩放 ,这 意味 着 当 整 个 布局 控件 的 大 小 发 生变 化 的 时 候 , 可 以 指定 某 些 
行 或 者 列 随 着 整个 布局 控件 的 缩放 而 缩放 . 


创建 一 个 wxFlexGridSizer 可 以 指定 行 数 , 列 数额 外 的 垂直 间距 和 水 平 间距 .调用 Add 画 数 的 方法 
和 wxBoxSizer 相 同 . 


下 图 演示 了 一 个 使 用 wxFlexGridSizer 进 行 布局 的 对 话 框 的 样子 ,正如 你 看 到 的 那样 ,和 
wxGridSizer 相 比 整个 布局 显 的 更 紧凑 了 ,因为 中 间 很 宽 的 那 一 列 不 再 影响 其 它 列 的 宽度 了 . 


Flex grid sizer dialog 


Two (the second button) 





初始 情况 下 ,我 们 看 不 出 来 设置 第 一 列 可 以 改变 大 小 的 效果 ,不 过 如 果 我 们 如 下 图 所 示 的 那样 改 
变 这 个 对 话 框 的 水 平方 向 的 大 小 ,, 我 们 就 可 以 看 到 第 一 列 占用 了 额外 增加 的 空间 ,并 且 第 一 列 的 
子 元 素 也 为 居中 方式 显 式 . 


Flex grid sizer dialog 


Two [the second button] 





代码 如 下 : 


MyDialog: :MyDialog(wxWindow *parent, wxWindowID id, 
const wxString &title ) 
: wxDialog(parent, id, title, 
wxDefaultPosition, wxDefaultSize, 
wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER) 


// 创 建 一 个 复 末 网 格 布局 控件 

wxFlexGridSizer* flexGridSizer = new wxFlexGridSizer(2, 3, 0, 0); 

this->SetSizer(flexGridSizer) ; 

// 让 第 一 列 可 变 大 小 

flexGridSizer ->AddGrowableCol(Q); 

wxButton* buttoni = new wxButton(this, ID_BUTTON1, wxT("One")); 

flexGridSizer->Add(button1, ©, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 

wxButton* button2 = new wxButton(this, ID_BUTTON2, wxT("Two (the second button)")); 

flexGridSizer->Add(button2, ©, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 

wxButton* button3 = new wxButton(this, ID_BUTTON3, wxT("Three")); 

flexGridSizer->Add(button3, ©, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 

wxButton* button4 = new wxButton(this, ID_BUTTON4, wxT("Four")); 

flexGridSizer->Add(button4, ©, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 

wxButton* button5 = new wxButton(this, ID_BUTTON5, wxT("Five")); 

flexGridSizer->Add(button5, ©, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 

wxButton* button6 = new wxButton(this, ID_BUTTON6, wxT("Six")); 

flexGridSizer->Add(button6, ©, wxALIGN_CENTER_HORIZONTAL | 
wxALIGN_CENTER_VERTICAL|wxALL, 5); 

flexGridSizer->Fit(this); 

flexGridSizer->SetSizeHints(this); 


} 
ale = 


使 用 wxGridBagSizer 编 程 


这 种 布局 控件 用 来 模拟 现实 世界 中 的 那 种 固定 位 置 和 大 小 的 基于 布局 控件 的 布局 . 它 将 它 的 子 
元 素 按照 一 个 虚拟 的 网 格 进行 排列 ,不 过 子 元 素 的 位 置 是 通过 wxGBPosition 对 象 指定 的 ,对 象 的 
大 小 使 用 wxGBSpan 指 定 ,对 象 的 大 小 不 仅 限 于 一 个 网 格 . 


创建 wxGridBagSizer 的 可 选 参数 包括 垂直 和 水 平方 向 的 间隔 (默认 为 0),Add 画 数 需要 提供 的 参 
数 包 括 子 元 素 的 位 置 和 大 小 ,另外 的 可 选 标 记 和 边框 大 小 参数 的 意义 和 wxBoxSizer 是 一 样 的 . 


下 图 演示 了 一 个 使 用 wxGridBagSizer 进 行 布局 的 例子 ,我 们 指定 了 其 中 一 个 按钮 的 大 小 为 两 个 
单元 列 ,我 们 还 指定 了 第 二 行 和 第 三 列 的 大 小 是 可 以 变化 的 ,这 样 当 我 们 改变 对 话 框 的 大 小 的 时 
候 , 就 会 出 现 如 下 面 另外 一 幅 图 的 效果 . 


Two [2.2] 
Three (3,2) Four (3,3) 


相关 代码 如 下 : 





MyDialog: :MyDialog(wxWindow *parent, wxWindowID id, 
const wxString &title ) 
: wxDialog(parent, id, title, 
wxDefaultPosition, wxDefaultSize, 
wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER) 


wxGridBagSizer* gridBagSizer = new wxGridBagSizer(); 

SetTopSizer (gridBagSizer ); 

wxButton* b1 = new wxButton(this, wxID_ANY, wxT("One (0,0)")); 

gridBagSizer->Add(b1, wxGBPosition(0, 0)); 

wxButton* b2 = new wxButton(this, wxID_ANY, wxT("Two (2,2)")); 

gridBagSizer ->Add(b2, wxGBPosition(2, 2), wxGBSpan(1, 2), 
wxGROW) ; 

wxButton* b3 = new wxButton(this, wxID_ANY, wxT("Three (3,2)")); 

gridBagSizer ->Add(b3, wxGBPosition(3, 2)); 

wxButton* b4 = new wxButton(this, wxID_ANY, wxT("Four (3,3)")); 

gridBagSizer ->Add(b4, wxGBPosition(3, 3)); 

gridBagSizer ->AddGrowableRow(3) ; 

gridBagSizer ->AddGrowableCol(2); 

gridBagSizer->Fit(this) ; 

gridBagSizer ->SetSizeHints(this); 


7.4 更 多 关于 布局 的 话题 


这 一 节 里 ,我 们 将 讨论 一 些 更 深入 的 话题 ,在 进行 窗口 布局 的 时 候 , 你 可 以 在 脑子 里 考虑 这 些 事 
情 . 


对 话 框 单位 


尽管 布局 控件 可 以 让 基本 控件 的 大 小 随 着 平台 的 不 同 语言 的 不 同 进行 相应 的 改变 ,但 是 有 些 情 
况 下 ,你 还 是 需要 手动 指定 控件 的 大 小 (比如 在 对 话 框 中 增加 一 个 列表 框 的 时 候 ). 如 果 你 希望 这 
些 手动 指定 的 大 小 也 随 着 平台 的 不 同 字体 的 不 同 进行 相应 的 变化 ,你 应 该 使 用 对 话 框 单位 来 代 
蔡 象 素 单 位 .对 话 框 单位 是 基于 应 用 程序 当前 字体 的 字符 宽度 和 高 度 所 取 的 一 个 平均 值 的 ,因此 
总 能 很 好 的 和 当前 的 字体 对 应 .wxWidgets 也 提供 了 相关 的 转换 函数 包括 : 
ConvertDialogToPixels,ConvertPixelsToDialog 等 ,还 包括 一 个 宏 wxDLG_UNIT(window, 
ptOrSz) 用 来 直接 将 使 用 对 话 框 单位 wxPoint 对 象 或 者 WxSize 对 象 转换 为 象 素 单位 .所 以 你 可 以 
使 用 下 面 的 代码 来 指定 那些 你 不 得 不 指定 的 控件 大 小 : 


wxListBox* listBox = new wxListBox(parent, wxID_ANY, 
wxDefaultPosition, wxDLG_UNIT(parent, wxSize(60, 20))); 


你 也 可 以 在 XRC 文 件 中 使 用 对 话 框 单位 ,只 需要 在 相应 的 值 前 面 增加 一 个 "d" 字 符 就 可 以 了 . 
平台 自 适应 布局 


尽管 不 同 平台 的 对 话 框 的 绝 大 部 分 都 是 相同 的 ,但 是 在 风格 上 确 是 存在 着 一 些 不 同 .比如 在 
Windows 和 Linnx 平 台 上 , 右 对 齐 或 者 居中 放置 的 OK,Cancel 和 Help 按 钮 都 是 可 以 接受 的 ,但 是 在 
Mac OsX 上 ,Help 按 钮 通常 位 于 左面 ,而 Cancel 和 OK 按钮 则 通常 依 序 位 于 右面 . 


要 作 到 这 种 不 同 平台 上 按钮 顺序 的 自 适 应 ,你 需要 使 用 wxStdDialogButtonSizer 布 局 控件 ,这 个 
控件 继承 自 wxBoxSizer, 因 此 使 用 方法 并 没有 太 大 的 不 同 ,只 是 它 依照 平台 的 不 同 对 某 些 按钮 进 
行 特 殊 的 排列 . 


这 个 布局 控件 的 构造 本 数 没有 参数 ,要 增加 按钮 可 以 使 用 两 种 方法 :传递 按钮 指针 给 AddButton 
男 数 , 或 者 (日 过 你 没有 使 用 标准 的 标识 符 的 话 ), 使 用 SetAffirmativeButton, SetNegativeButton, 
and SetCancelButton 来 设置 按钮 的 特性 .如 果 使 用 AddButton, 那 么 按钮 应 使 用 下 面 的 这 些 标识 
符 : wxID_OK, wxID_YES, wxID_CANCEL, wxID_NO, wxID_SAVE, wxID_APPLY, 
wxID_HELP 和 wxID_CONTEXT_HELP. 


然后 ,在 所 有 的 按钮 都 增加 到 布局 控件 以 后 ,调用 Realize 沙 数 以 便 布 局 控件 调整 按钮 的 顺序 ,如 
下 面 的 代码 所 示 : 


wxBoxSizer* topSizer = new wxBoxSizer(wxVERTICAL) ; 
dialog->SetSizer(topSizer); 

wxButton* ok = new wxButton(dialog, wxID_OK); 
wxButton* cancel = new wxButton(dialog, wxID_CANCEL); 
wxButton* help = new wxButton(dialog, wxID_HELP); 
wxStdDialogButtonSizer* buttonSizer = new wxStdDialogButtonSizer ; 
topSizer->Add(buttonSizer, ©, wxEXPAND|wxALL, 10); 
buttonSizer ->AddButton(ok) ; 

buttonSizer ->AddButton(cancel); 

buttonSizer ->AddButton(help) ; 

buttonSizer->Realize(); 


或 者 作为 一 个 更 方便 的 手段 ,你 可 以 使 用 wxDialog::CreateButtonSizer 函 数 , 它 基 于 一 些 按钮 标 
记 的 列表 来 自动 创建 平台 自 适 应 的 按钮 ,并 将 其 放 在 一 个 布局 控件 中 ,如 果 你 查看 src/generic 目 
录 中 的 对 话 框 代 码 的 实现 ,你 会 发 现 大 量 的 地 方 使 用 了 CreateButtonSizer 函 数 .这 个 函数 支持 
的 按钮 标记 如 下 表 所 示 : 


wxYES_NO 增加 YES 和 No 按钮 各 一 个 . 

wxYES 增加 一 个 标识 符 为 wxID YES 的 Yes 按 钮 . 

wxNO 增加 一 个 标识 符 为 wxID_NO 的 No 按钮 . 

wxNO_DEFAULT 让 No 按钮 作为 默认 按钮 ,否则 Yes 或 OK 按钮 将 成 为 默认 按钮 
wxOK 增加 一 个 标识 符 为 wxID_OK 的 OK 按钮 . 

wxCANCEL 增加 一 个 标识 符 为 wxID_CANCEL 的 Cancel 按 钮 . 
wxAPPLY 增加 一 个 标识 符 为 wxID_APPLY 的 Apply 按 钮 . 

wxHELP 增加 一 个 标识 符 为 wxID_HELP 的 Help 按 钮 . 


使 用 CreateButtonSizer 本 数 ,上 面 例子 中 的 代码 可 以 简化 为 : 


wxBoxSizer* topSizer = new wxBoxSizer(wxVERTICAL) ; 

dialog->SetSizer(topSizer); 

topSizer ->Add(CreateButtonSizer (wxOK|wxCANCEL|wxHELP), 0, 
wxEXPAND|wxALL, 10); 


另外 一 种 给 不 同 的 平台 指定 不 同 布局 的 方法 是 在 XRC 文 件 中 指定 平台 属性 .其 中 的 参数 部 分 的 
值 可 以 通过 一 个 "|" 符 号 加 上 unix, win,mac 或 者 0s2 来 指定 特定 平台 上 的 界面 布局 .在 应 用 程序 运 
行 的 时 候 ,XRC 文 件 将 只 会 创建 那些 和 当前 运行 平台 符合 的 控件 .另外 如 果 没 有 使 用 XRC 的 

话 ,DialogBlocks 程 序 还 支持 针对 不 同 的 平台 生成 预 置 条 件 的 C++ 代码 . 


当然 你 也 可 以 给 不 同 的 平台 指定 不 同 的 XRC 文 件 ,不 过 这 样 作 的 话 维护 起 来 就 有 点 不 方便 了 . 
动态 布局 


有 时 候 你 可 能 需要 动态 更 改 对 话 框 的 布局 ,比如 你 可 以 会 增加 一 个 "Detail" 按 钮 , 当 这 个 按钮 被 按 
下 的 时 候 显 式 更 多 的 选项 ,当然 你 可 以 使 用 平常 的 办 法 ,调用 wxWindow::Show 男 数 来 隐藏 某 个 
控件 ,不 过 wxSizer 也 提供 了 一 个 单独 的 方法 ,你 可 以 使 用 wxSizer:: Show 函 数 并 且 传 递 False 参 


数 ,以 便 告诉 wxSizer 不 要 计算 其 中 的 窗口 的 大 小 ,当然 调用 这 个 画 数 以 后 ,你 需要 调用 wxSizer:: 
Layout 范 数 来 强制 更 新 对 应 的 窗口 . 


第 七 草 小 结 


布局 控件 可 能 需要 花 点 时 间 才 能 慢 慢 习惯 使 用 ,因此 ,如 果 你 觉得 这 一 章 的 内 容 有 点 沉重 ,不 要 担 
心 .掌握 它们 最 好 的 办 法 是 使 用 光盘 中 附带 的 DialogBlocks 软 件 进行 各 种 各 样 的 窗口 布局 ,然后 
观看 其 自动 产生 的 代码 .你 也 可 以 参考 WxWidgets 自 带 的 samples/layout 中 的 例子 .在 你 可 以 熟 
练 使 用 它们 以 后 ,你 会 发 现 ,它们 在 不 同 平台 和 不 同 语言 下 进行 布局 的 能 力 ,可 以 让 你 的 产品 极 大 
的 受益 . 


在 下 一 章 中 ,我 们 来 看 一 看 wxWidgets 提 供 的 标准 对 话 框 . 


第 八 章 使 用 标准 对 话 框 


本 章 描述 了 wxWidgets 提 供 的 标准 的 对 话 框 ,使 用 这 些 这 些 对 话 框 ,你 只 用 很 少 的 代码 就 可 以 用 
来 显示 一 些 信 息 或 者 从 用 户 那里 获取 数据 .熟悉 这 些 标准 的 对 话 框 将 会 节省 你 大 量 的 时 间 , 并 且 
让 你 的 程序 显得 更 专业 .wxWidgets 在 任何 可 能 的 时 候 使 用 本 地 原生 的 对 话 框 ,但 是 有 些 时 
候 ,wxWidgets 也 是 一 些 自己 的 对 话 框 ,比如 wxTextEntryDialog, 这 些 对 话 框 统称 为 一 般 的 对 话 
框 .在 这 一 章 中 ,对 于 那些 在 各 个 平台 上 和 外观 有 较 大 差别 的 对 话 框 ,也 给 予 了 单独 的 图 片 说 明 . 


我 们 人 为 的 把 标准 对 话 框 分 成 了 以 下 四 类 :信息 对 话 框 ,文件 和 目录 对 话 框 ,选项 和 选择 对 话 框 以 
及 输入 对 话 框 . 


8.1 信 息 对 话 框 
在 这 一 小 节 中 ,我 们 来 看 看 以 下 四 种 用 来 提供 信息 的 对 话 框 :wxMessageDialog， 
wxProgressDialog, wxBusylnfo, and wxShowTip. 


wxMessageDialog 


这 种 对 话 框 显 示 一 个 消息 和 一 组 按钮 ,按钮 可 以 为 OK, Cancel, Yes 或 者 No, 还 可 以 有 一 个 可 选 
的 图 标 ,用 来 显示 一 个 惊叹 号 或 者 一 个 问号 .消息 文本 中 还 可 以 包含 换行 符 "\n". 


wxMessageDialog::ShowModal 本 数 的 返回 值 用 来 表征 哪个 按钮 被 按 下 了 . 


下 图 显示 了 wxMessageDialog 在 windows 平 台 上 的 样子 : 


Message box text 


This is a message box 
4 long, long string to test out the message box properly 


i Cancel 





在 GTK+ 平 台 


bd Message box text 
( This is a message box 
= Along, long string to test out the message box properly 











在 Mac 平 台 





Message box text 


This is a message box 
A long, long string to test out the message box properly 














要 创建 一 个 这 种 对 话 框 ,你 需要 提供 父 窗口 指针 ,要 显示 的 消息 ， 参数 , 然 
后 调用 ShowModal 函 数 显 示 这 个 对 话 框 ,然后 判断 这 个 画 数 的 返 进行 进一步 的 动作 . 


其 中 的 类 型 参数 是 一 个 比特 位 列表 ,其 值 如 下 表 所 示 : 


wxOK 
wxCANCEL 
wxYES_ NO 


wxYES_DEFAULT 


wxNO_DEFAULT 
wxICON_EXCLAMATION 
wxICON_ERROR 
wxlICON_HAND 
wxICON_QUESTION 
wxlICON_INFORMATION 


wxSTAY_ON_TOP 


wxMessageDialog{# FA # ll 


#include "wx/msgdlg.h" 


显示 一 个 OK 按钮 . 
显示 一 个 Cancel 按 向 . 
显示 Yes 和 No 按钮 . 


设置 Yes 为 默认 按钮 . 和 wxYES_NO 一 起 使 用 .这 是 
WXYES_NO 类 型 的 默认 行为 . 

设置 No 按钮 为 默认 按钮 ,和 wxYES_NO 〇 一 起 使 用 . 
显示 一 个 惊叹 号 . 

显示 一 个 错误 图 标 . 

和 wxICON_ERROR 相 同 . 

Em—Tiqs. 


显示 一 个 信息 图 标 . 


在 windows 平 台 上 ,这 个 对 话 框 将 在 所 有 的 窗口 (包括 那些 其 
它 应 用 程序 的 窗口 ) 之 上 . 


wxMessageDialog dialog( NULL, wxT("Message box caption"), 
wxT("Message box text"), 
wxNO_DEFAULT |wxYES_NO |wxCANCEL |wxICON_INFORMATION) ; 
switch ( dialog.ShowModal() ) 


{ 


case wxID_YES: 


wxLogStatus(wxT("You pressed \"Yes\"")); 


break; 
case wxID_NO: 


wxLogStatus(wxT("You pressed \"No\"")); 


break; 
case wxID_CANCEL: 


wxLogStatus(wxT("You pressed \"Cancel\"")); 


break; 
default: 


wxLogError(wxT("Unexpected wxMessageDialog return code!")); 


wxMessageBox 


Ñ 


4K BY LA (5 FA BB 75 (2 wxMessageBoxW, CHER 4 —MA BMA MMA, AWANA. 
例如 : 


if (wxYES == wxMessageBox(wxT("Message box text"), 
wxT("Message box caption"), 
wxNO_DEFAULT |wxYES_NO|wxCANCEL | wxICON_INFORMATION, 
parent) ) 


return true; 


要 注意 wxMessageBox 的 返回 值 和 wxMessageDialog::ShowModal 的 返回 值 是 不 一 样 的 ,前 者 
返回 wxOK, wxCANCEL, wxYES 或 wxNO, 而 后 者 返回 wxID_OK, wxID_CANCEL, wxID_YES 
或 wxID_NO. 


wxProgressDialog 


wxProgressDialog 可 以 用 来 显示 一 个 短 的 消息 文本 和 一 个 进度 条 用 来 指示 用 户 还 需要 等 待 多 
久 . 它 还 可 以 显示 一 个 Cancel 按钮 用 来 中 止 正在 进行 的 处 理 ,还 可 以 显示 已 经 过 去 的 时 间 , 估 计 
剩余 的 时 间 和 估计 全 部 的 时 间 . 这 个 对 话 框 是 wxWidgets 在 各 个 平台 上 自己 实现 的 .下 图 显示 了 
这 个 对 话 框 在 windows 上 的 样子 : 


Progress dialog example 


4n informative message 





Elapsed time : 0:00:05 
Estimated time : 0:00:16 
Remaining time : 0:00:11 


Cancel 





你 既 可 以 用 全 局 变量 或 者 new 函 数 来 创建 这 种 对 话 框 ,也 可 以 直接 使 用 局 部 变量 创建 这 种 对 话 
框 ,需要 传递 的 参数 包括 :标题 ,消息 文本 ,进度 条 的 最 大 值 , 父 窗口 和 类 型 . 


类 型 的 值 如 下 表 所 示 : 
置 为 模式 对 话 框 .如 果 没 有 设置 这 个 类 型 ,对 话 框 为 非 模式 
wxPD_APP_MODAL 对 话 框 ,意味 着 除了 其 父 窗口 以 外 ,点 用 程序 中 其 它 的 窗口 还 
可 以 输入 数据 . 
wxPD_AUTO_HIDE 导致 这 个 进度 条 对 话 框 在 进度 达到 最 大 值 的 时 候 自动 消失 . 


告诉 对 话 框 显示 一 个 取消 按钮, 当 用 户 点 击 这 个 按钮 以 后 ,下 
次 调用 对 话 框 的 Update 函 数 将 会 返回 失败 . 


wxPD_ELAPSED_TIME 显示 已 逝去 时 间 标 签 . 
wxPD_ESTIMATED TIME ”显示 估计 全 部 时 间 标 签 . 
wxPD_REMAINING TIME ”显示 估计 剩余 时 间 标 签 . 


wxPD_CAN_ABORT 


在 进度 对 话 框 被 创建 以 后 ,其 父 窗口 将 被 禁用 ,如 果 设 置 了 wxPD_APP_MODAL 类 型 , 则 应 用 程 
序 中 其 它 的 窗口 也 将 被 禁用 .应用 程序 应 用 调用 Update 函 数 来 更 新 进度 条 以 及 提示 信息 ,如 果 设 
置 了 时 间 显 示 标 签 , 则 它们 的 值 将 被 自动 计算 并 在 每 次 调用 Update 的 时 候 刷 新 . 


如 果 设 置 了 wxPD_AUTO_HIDE 类 型 ,对 话 框 会 在 进度 达到 最 大 值 的 时 候 自 动 隐藏 ,你 应 该 自己 
根据 其 创建 方式 释放 这 个 对 话 框 . 对 于 由 于 用 户 点 击 取消 按钮 而 导致 Update 失 败 的 情况 ,如 果 你 
愿意 ,你 可 以 使 用 Resume 画 数 还 恢复 中 止 的 进度 条 . 


wxProgressDialog 使 用 举例 


#include "wx/progdlg.h" 
void MyFrame: :ShowProgress() 


{ 
static const int max = 10; 
wxProgressDialog dialog(wxT("Progress dialog example"), 
wxT("An informative message"), 
max, // range 
this, // parent 
wxPD_CAN_ABORT | 
wxPD_APP_MODAL | 
wxPD_ELAPSED_TIME | 
wxPD_ESTIMATED_TIME | 
wxPD_REMAINING_TIME); 
bool cont = true; 
for ( int i = 0; i &lt;= max; i++ ) 
{ 
wxSleep(1); 
if ( i == max ) 
cont = dialog.Update(i, wxT("That's all, folks!")); 
else if ( i == max / 2 ) 
cont = dialog.Update(i, wxT("Only a half left (very long message)!")); 
else 
cont = dialog.Update(i); 
if ( !cont ) 
{ 
if ( wxMessageBox(wxT("Do you really want to cancel?"), 
wxT("Progress dialog question"), 
wxYES_NO | wxICON_QUESTION) == wxYES ) 
break; 
dialog.Resume(); 
} 
if ( !cont ) 
wxLogStatus(wxT("Progress dialog aborted!")); 
else 
wxLogStatus(wxT("Countdown from %d finished"), max); 
} 
wxBusylnfo 


wxBusylnfo 其 实 不 是 一 个 对 话 框 不 过 它 的 表现 和 对 话 框 非常 相似 , 当 这 个 对 象 被 创建 的 时 候 , 屏 
幕 上 将 显示 一 个 窗口 以 及 一 条 让 用 户 耐心 等 待 的 消息 ,这 个 窗口 将 存在 于 wxBusylnfo 的 整个 生 
命 周期 .在 windows 平 台 上 , 它 的 长 相 类 似 下 面 的 样子 : 


Counting, please wait... 


wxBusyInfots TAAS a Al eB Ah 6) E, SS 4 HIGHWANSMa—TAAMAA 
一 个 父 窗口 . 


wxBusylnfo 使 用 举例 


在 下 面 的 例子 中 ,首先 使 用 wxWindowDisabler 对 象 禁 用 应 用 程序 当前 创建 的 所 有 的 窗口 ,然后 
显示 了 一 个 wxBusylnfo 窗 口 : 


#include "wx/busyinfo.h" 

wxWindowDisabler disableAl1; 

wxBusyInfo info(wxT("Counting, please wait..."), parent); 
for (int i = 0; i &lt; 1000; i++) 


DoCalculation(); 


wxShowTip 


许多 应 用 程序 都 会 在 程序 启动 的 时 候 显示 一 个 附加 的 窗口 ,用 来 给 出 一 些 如 何 使 用 这 个 应 用 程 
序 的 提示 信息 ,那些 不 愿 阅读 沉闷 的 文档 的 人 会 非常 喜欢 这 样 的 学 习 方式 的 . 


启动 提示 窗口 在 windows 平 台 上 的 样子 如 下 图 所 示 : 


Tip of the Day 


V Did you know... 


This tip is marked as a translatable string 
by wrapping it inside the usual gettext 
macro, so it can be collected by gettext 
and added to a translation catalog. Your 
application can then use this catalog and 
serve out a translated version of the tip. 


[V] Show tips at startup I Nest Tip | 





和 大 多 数 对 话 框 不 同 ,这 个 对 话 框 是 使 用 wxShowTip 辑 数 显示 的 ,传递 的 参数 为 一 个 父 窗 口 指针 ， 
一 个 指向 wxTipProvider 对 象 的 指针 和 一 个 可 选 的 bool 参 数 用 来 指示 是 否 ae 
用 户 可 以 选择 是 否 在 应 用 程序 启动 的 时 候 显 示 这 个 提示 框 .而 函数 的 返回 值 则 为 用 户 的 选 


你 必须 实现 一 个 wxTipProvider 的 派生 类 ,实现 其 中 的 GetTip 画 数 才 可 以 使 用 wxShowTip 画 数 , 幸 

运 的 是 , wxWidgets 已 经 实现 了 一 个 这 样 的 基于 文本 文件 的 类 .你 可 以 直接 使 用 

ee te ea 传递 以 文本 文件 (每 行 一 个 提示 文本 ) 路 径 和 默认 选择 索引 来 创建 
这 样 的 类 . 


应 用 程序 应 负责 在 wxTipProvider 对 象 不 需要 的 时 候 释放 这 个 对 象 . 


wxShowTip 使 用 举例 


#include "wx/tipdlg.h" 
void MyFrame: :ShowTip() 


{ 
static size_t s_index = (size_t)-1; 
if ( s_index == (size_t)-1 ) 
// 随机 化 ,.， 


srand(time(NULL) ); 
// ,选择 一 个 提示 
s_index = rand() % 5; 


} 

// 传递 一 个 提示 文件 以 及 提示 索引 

wxTipProvider *tipProvider = 
wxCreateFileTipProvider(wxT("tips.txt"), s_index); 

m_showAtStartup = wxShowTip(this, tipProvider, true); 

delete tipProvider; 


8.2 文件 和 目录 对 话 框 


如 果 想 让 用 户 选 择 文件 和 目录 ,你 可 以 使 用 下 面 这 两 种 对 话 框 :wxFileDialog 和 wxDirDialog. 
wxFileDialog 


wxFileDialog 用 来 让 用 户 选择 一 个 或 多 个 文件 . 它 还 有 一 个 专门 用 来 打开 文件 或 者 保存 文件 的 
变 体 . 


下 图 演示 了 windows 平 台 上 文件 对 话 框 的 样子 : 
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GTK+ 版 本 : 


wxWidgets 跨 平台 GUI 编程 


iv} Testing open file dia log 
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GTK+ 2.4 以 上 版 本 : 
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Mac Os X 版 本 : 
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Testing open file dialog 
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创建 一 个 文件 对 话 框 需要 传递 的 参数 包括 一 个 父 窗口 ,一 个 显示 在 对 话 框 标 题 栏 的 消息 文本 , 默 
认 的 目录 ,默认 文件 名 ,通配符 ,对 话 框 类 型 和 显示 位 置 ( 有 些 平台 上 忽略 这 个 参数 ). 然 后 调用 其 
ShowModal 函 数 并 且 判 断 函 数 返回 值 ,如 果 返 回 值 为 wxID_OK 则 表明 用 户 确 认 了 文件 的 选择 . 


目录 名 和 文件 名 组 成 一 个 文件 全 路 径 . 如 果 目 录 名 为 空 , 则 默认 为 当前 工作 目录 ,如 果 文 件 名 为 
空 , 则 没有 默认 文件 名 . 


通配符 用 来 确定 哪 种 类 型 的 文件 应 该 显示 在 对 话 框 中 .通配符 可 以 用 "| "分割 多 种 文件 类 型 ,并 且 
可 以 提供 文件 类 型 的 描述 文字 ,具体 格式 如 下 所 示 : 


BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif 


如 果 在 文件 名 文本 区 输入 一 个 带 有 通配符 (*","?") 的 文件 名 ,然后 点 确定 按钮 ,将 会 导致 只 有 符合 
这 个 通 配 名 的 文件 名 被 显示 . 


wxFileDialog 的 类 型 

如 下 表 所 示 : 
wxSAVE 指定 为 一 个 保存 文件 对 话 框 . 
wxOPEN 指定 为 一 个 打开 文件 对 话 框 (默认 行为 ). 
wxOVERWRITE_PROMPT ”对 于 保存 文件 对 活 框 ,如 果 目 标 文件 已 经 存在 , 则 提示 是 否 
wxFILE_MUST_EXIT 用 户 只 能 选择 已 经 存在 的 文件 . 


wxMULTIPLE 用 户 可 以 选择 多 个 文件 . 


wxFileDialog 的 成 员 郴 数 


Getdirectory 返 回 默认 的 目录 名 或 者 单 选 文件 对 话 框 中 选中 文件 的 所 在 的 目录 名 ,使 用 
SetDirectory 设 置 默认 目录 . 


GetFilename 返 回 不 包括 目录 部 分 的 默认 文件 名 或 者 单 选 文件 对 话 框 中 选中 的 文件 的 文件 名 . 
使 用 SetFilename 设 置 默认 文件 名 . 


GetFilenames 使 用 wxArrayString 类 型 返回 多 选 文件 对 话 框 中 所 有 选中 的 文件 名 .通常 ,这 些 文 
件 名 是 不 含有 路 径 的 , 但 是 在 windows 平 台 上 ,如 果 选 中 的 是 一 个 快捷 方式 文件 ,windows 可 能 会 
增加 上 一 个 全 路 径 , 因 为 应 用 程序 无 法 通过 通过 增加 当前 的 目录 的 方式 来 得 到 其 全 路 径 .使 用 
GetPaths 可 以 得 到 包含 全 路 径 在 内 的 已 选中 文件 的 列表 . 


GetFilterlndex 用 来 返回 默认 的 基于 0 的 过 滤器 的 索引 .过 滤器 通常 以 一 个 下 拉 框 的 方式 显示 .使 
用 SetFilterlndex 设 置 默认 的 过 滤器 索引 . 


GetMessage 返 回 对 话 框 的 标题 文本 . 使 用 SetMessage 画 数 来 设置 标题 文本 . 


GetPath 以 全 路 径 的 方式 返回 单 选 文件 框 中 默认 文件 或 者 选中 文件 名 .对 于 多 选 框 ,应 使 用 
GetPathsH 2X. 


GetWildcard 返 回 指 定 的 通配符 , SetWildcard 用 来 设置 通配符 . 
wxFileDialog 例 子 


下 面 的 代码 用 来 创建 和 显示 一 个 用 来 打开 BMP 或 者 GIF 类 型 文件 的 对 话 框 : 


#include "wx/filedlg.h" 

wxString caption = wxT("Choose a file"); 

wxString wildcard = 
wxT("BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif"); 

wxString defaultDir = wxT("c:\\temp")); 

wxString defaultFilename = wxEmptyString; 

wxFileDialog dialog(parent, caption, defaultDir, defaultFilename, 
wildcard, wxOPEN); 

if (dialog.ShowModal() == wxID_OK) 

{ 


wxString path = dialog.GetPath(); 
int filterIndex = dialog.GetFilterIndex(); 
} 


wxDirDialog 


wxDirDialog 用 来 让 用 户 选 择 一 个 本 地 或 者 网 络 文件 夹 .如 果 在 构造 范 数 中 设置 了 可 选 类 型 
wxDD_NEW_DIR_BUTTON, 则 对 话 框 将 显示 一 个 用 来 创建 新 文件 夹 的 按钮 . 


下 图 演示 了 windows 平 台 上 的 目录 对 话 框 的 祥子 ,这 是 windows 系 统 提供 的 原生 控件 : 


wxWidgets 跨 平台 GUI 编程 
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linux 平 台 上 通常 使 用 GTK+ 版 本 的 wxDirDialog, 如 下 图 所 示 : 
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[C] Show hidden directories 
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Mac 平 台 上 的 wxDirDialog 和 文件 选择 对 话 框 非常 相似 ,如 下 图 所 示 : 
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创建 一 个 目录 对 话 框 需 要 传递 的 参数 包括 :一 个 父 窗口 ,一 个 标题 文本 ,一 个 默认 路 径 , 一 个 窗口 
类 型 以 及 一 个 位 置 和 大 小 (最 后 两 个 参数 在 某 些 平台 上 被 忽略 ), 然 后 调用 ShowModal 画 数 ,判断 
返回 值 是 否 为 wxID_OK 以 确定 用 户 是 否 进行 了 选择 . 


wxDirDialog 成 员 画 数 
SetPath 和 GetPath 用 来 获得 和 设置 用 户 选择 的 目录 . 
SetMessage 和 GetMessage 用 来 获取 和 设置 标题 文本 . 


wxDirDialog 使 用 举例 


#include "wx/dirdlg.h" 

wxString defaultPath = wxT("/"); 

wxDirDialog dialog(parent, 
wxT("Testing directory picker"), 
defaultPath, wxDD_NEW_DIR_BUTTON); 

if (dialog.ShowModal() == wxID_OK) 

{ 
wxString path = dialog.GetPath(); 
wxMessageBox(path); 


8.3 选择 和 选项 对 话 框 

在 这 一 小 节 中 ,我 们 来 看 看 那些 让 你 作出 选择 或 者 允许 你 给 出 选项 的 对 话 框 , 包 

括 :wxColourDialog, wxFontDialog, wxSingleChoiceDialog 和 wxMultiChoiceDialog. 
wxColourDialog 

这 个 对 话 框 允 许 用 户 从 标准 颜色 或 者 是 一 个 颜色 范围 中 选择 一 种 颜色 . 


在 windows 系 统 上 ,颜色 选择 对 话 框 使 用 的 是 windows 系 统 提供 的 原生 控件 ,这 个 对 话 框 主 要 包 
含 三 个 区 域 ,左上 角 是 一 个 由 48 中 常用 颜色 组 成 的 区 域 ,左下 角 是 一 个 拥有 16 个 选项 的 定制 颜色 
区 ,用 户 的 点 用 程序 可 以 自行 设置 这 16 种 定制 的 颜色 ,右边 则 可 以 展开 用 来 精确 的 选择 一 个 颜 
色 . 下 图 演示 了 这 个 对 话 框 完全 展开 以 后 的 样子 : 


Choose the background colour 
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通用 的 颜色 选择 对 话 框 如 下 图 所 示 , 可 以 在 GTK+ 1 或 者 X11 系 统 上 使 用 . 它 包含 48 个 常用 颜色 和 
16 个 可 定制 颜色 ,右边 包含 三 个 滑 条 用 来 选择 RGB 三 原色 的 值 . 选 好 的 值 用 来 替换 当前 选中 的 定 
制 颜色 或 者 (如 果 当 前 没有 选中 任何 定制 颜色 的 话 ) 第 一 个 定制 颜色 .和 windows 系 统 原 生 的 颜 
色 选 择 框 不 同 ,右边 的 滑 条 区 域 是 不 可 以 隐藏 的 .在 Windows 平 台 和 其 它 平台 上 ,你 也 可 以 通过 
wxGenericColourDialog 类 来 使 用 这 个 通用 颜色 选择 对 话 框 . 
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Mac OsX 平 台 上 的 颜色 选择 对 话 框 如 下 图 所 示 : 
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要 使 用 颜色 选择 对 话 框 ,你 可 以 创建 一 个 wxColourDialog 局 部 变量 ,传递 的 参数 包括 父 窗 口 指 针 
和 一 个 wxColourData 指针 ,后 者 用 来 设置 一 些 默 认 数 据 , 然 后 调用 ShowModal 函 数 , 当 这 个 函数 
返回 时 ,通过 GetColourData 辑 数 获取 用 户 对 wxColourData 所 做 的 更 改 . 


wxColourData 的 成 员 画 数 


SetChooseFull 定 义 在 windows 平 台 上 ,颜色 选择 对 话 框 应 该 是 完全 展开 的 方式 显示 .否则 将 只 
显示 左边 的 部 分 .GetChooseFull 男 数 则 用 来 获取 Bool 格 式 的 这 个 选项 的 值 . 


SetColour 用 来 设置 默认 的 颜色 , GetColour 函 数 用 来 返回 用 户 当前 选择 的 颜色 . 


SetCustomColour 使 用 一 个 0 到 15 之 间 的 索引 和 一 个 wxColour 类 型 的 颜色 值 来 设置 颜色 选择 对 
话 框 的 定制 颜色 .使 用 GetCustomColour 函 数 返 回 当 前 的 可 定制 范围 的 颜 色 值 ,这 个 值 可 能 在 用 
户 操作 颜色 对 话 框 的 过 程 中 被 改变 . 


wxColourDialog 使 用 举例 


下 面 是 一 个 使 用 wxColourDialog 的 例子 , 它 将 首先 设置 wxColourData 的 各 种 参数 ,包括 16 个 灰 
阶 色彩 的 定制 颜色 .如 果 用 户 没有 取消 这 个 对 话 框 ,就 用 用 户 选择 的 颜色 来 设置 当前 的 背景 色 . 


#include "wx/colordlg.h" 
wxColourData data; 
data.SetChooseFull(true) ; 

for (int i = 0; i &lt; 16; i++) 


wxColour color(i*16, i*16, i*16); 
data.SetCustomColour(i, color); 
} 
wxColourDialog dialog(this, &data); 
if (dialog.ShowModal() == wxID_OK) 


{ 
wxColourData retData = dialog.GetColourData(); 
wxColour col = retData.GetColour(); 
myWindow->SetBackgroundColour (col); 
myWindow->Refresh(); 

} 


wxF ontDialog 
wxFontDialog 可 以 让 用 户 来 选择 一 个 字体 (在 某 些 平台 上 ,还 可 以 选择 字体 的 颜色 )， 


在 Windows 平 台 上 ,使 用 的 是 windows 系 统 提 供 的 原生 控件 ,这 个 控件 给 用 户 的 选择 包括 字体 的 
名 称 ,点 大 小 ,类 型 ,粗细 ,下 划 线 ,中 划 线 等 属性 以 及 字体 的 前 景 颜 色 .一 个 白色 区 域 还 显示 了 当前 
选择 字体 的 样子 .注意 在 windows 的 字体 转换 到 wxWidgets 的 字体 过 程 中 ,中 划 线 属性 将 被 忽略 ， 
字体 名 称 则 被 相应 的 字体 家 族 名 称 取 代 . 而 在 GTK+ 平 台 上 ,使 用 的 是 GTK+ 的 标准 字体 对 话 框 ， 
这 个 对 话 框 不 允许 选择 字体 前 景 颜色 . 


下 图 演示 了 windows 平 台 上 字体 选择 对 话 框 的 样子 : 
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下 图 演示 了 GTK+ 上 的 标准 字体 选择 对 话 框 的 样子 : 
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除了 上 述 两 个 平台 以 外 ,其 它 平台 字体 选择 对 话 框 的 样子 都 很 相似 ,允许 用 户 选 择 的 项 目 包 括 字 
大 小 ,类 型 ,粗细 ,下 划 线 以 及 前 景 颜色 等 ,还 包括 一 个 示例 区 用 来 显示 当前 字体 的 样 

这 种 字体 选择 框 在 各 种 平台 都 是 可 以 使 用 的 , 类 的 名 字 为 wxGenericFontDialog. 下 图 演示 了 
a 文 种 字体 选择 对 话 框 的 样子 : 
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人 omy > 











要 使 用 字体 选择 对 话 框 ,需要 传递 的 参数 包括 父 窗口 和 一 个 wxFontData 对 象 ,然后 调用 其 
ShowModal 函 数 并 且 测 试 其 返回 值 是 否 为 wxID_OK, 然 后 从 对 话 框 中 获取 wxFontData 数 据 , 然 
后 视 需 要 调用 其 GetChosenFont 和 GetChosenColour 画 数 . 


wxFontDataByAx A EBX 


EnableEffects 函 数 允 许 windows 平 台 上 的 字体 选择 对 话 框 或 者 通用 版 本 的 字体 选择 对 话 框 显 
示 颜 色 和 下 划 线 属性 控制 .在 GTK 版 本 上 则 没有 任何 效果 . et a 
前 是 否 设置 了 这 个 标志 . 不 过 即使 禁止 了 这 个 标志 ,字体 颜色 选 会 被 保留 . 


0 GetAllowSymbols 则 返回 这 个 选项 的 
当前 设置 


SetColour 设 置 默认 字体 颜色 , GetColour 则 返回 当前 用 户 选择 的 颜色 . 


SetlnitialFont 返 回 对 话 框 被 创建 时 候 的 默认 字体 . GetChosenFont 则 返回 用 户 选 择 的 字体 
(wxFont). 


SetShowHelp 用 来 指示 应 该 在 字体 对 话 框 上 显示 帮助 按钮 ( 仅 适 用 于 Windows). GetShowHelp 
则 返回 这 个 选项 的 当前 设置 


SetRange 设 置 用 户 可 以 选择 的 字体 大 小 的 范围 , 默认 值 (0, 0) 表 示 任 何 大 小 的 字体 都 可 以 被 选 
择 . 仅 适用 于 windows. 


字体 选择 使 用 举例 
在 下 面 的 例子 中 ,应 用 程序 使 用 字体 选择 对 话 框 返回 的 字体 在 窗口 上 给 


#include "wx/fontdlg.h" 

wxFontData data; 

data.SetInitialFont(m font); 

data.SetColour(m_textColor) ; 

wxFontDialog dialog(this, &data); 

if (dialog.ShowModal() == wxID_OK) 

{ 
wxFontData retData = dialog.GetFontData(); 
m_font = retData.GetChosenFont(); 
m_textColor = retData.GetColour(); 
// 更 新 当前 窗口 以 便 使 用 当前 选择 的 字体 和 颜色 进行 重 绘 
myWindow->Refresh(); 


wxSingleChoiceDialog 


wxSingleChoiceDialog 给 用 户 提 供 了 一 组 字符 串 以 便 用 户 可 以 选择 其 中 的 一 个 . 它 的 外 观 如 下 
图 所 示 : 


Please select a value 


This is a small sample 
À single-choice convenience dialog 





传递 给 构造 图 数 的 参数 包括 其 父 窗口 指针 ,一 个 消息 文本 ,对 话 框 的 标题 文本 以 及 一 个 
wxArrayString 类 型 的 字符 串 选项 列表 .其 中 最 后 一 个 参数 可 以 使 用 一 个 大 小 和 一 个 C 类 型 的 字 
符 串 指针 的 指针 (wxChar”“) 代 蔡 . 


SetSelection 用 来 在 对 话 框 显示 之 前 设置 一 个 默认 的 选项 ,使 用 GetSelection( 返 回 当 前 选项 的 
索引 ) 或 者 GetStringSelection( 返 回 对 应 的 字符 串 ) 来 在 对 话 框 关闭 以 后 获取 用 户 的 选择 . 


你 还 可 以 在 这 种 对 话 框 的 构造 画 数 中 传递 一 组 char* 类 型 的 客户 区 数据 ,在 对 话 框 被 关闭 以 后 ,使 
用 GetSelectionClientData 本 数 获得 和 用 户 选 项 对 应 的 客户 区 数据 . 


wxSingleChoiceDialog 使 用 举例 


#include "wx/choicdlg.h" 

const wxArrayString choices; 

choices.Add(wxT("One") ); 

choices.Add(wxT("Two") ); 

choices.Add(wxT("Three") ); 

choices.Add(wxT("Four")); 

choices.Add(wxT("Five")); 

wxSingleChoiceDialog dialog(this, 
wxT("This is a small sample\nA single-choice convenience dial 
wxT( "Please select a value"), 
choices); 

dialog.SetSelection(2); 

if (dialog.ShowModal() == wxID_OK) 

wxMessageBox(dialog.GetStringSelection(), wxT("Got string")); 


4 


wxMultiChoiceDialog 





wxMultiChoiceDialog 和 wxSingleChoiceDialog 很 相似 ,不 过 它 允 许 用 户 进 行 多 项 选择 .这 种 对 话 
框 的 外 观 如 下 图 所 示 : 


Please select a yalue 


This is a small sample 














传递 给 这 种 对 话 框 的 构造 画 数 的 参数 包括 一 个 父 窗口 指针 ,一 个 消息 文本 ,对 话 框 标题 文本 和 一 
个 wxArrayString 类 型 的 选项 列表 . 和 wxSingleChoiceDialog 一 样 ,最 后 一 个 参数 可 以 使 用 字符 
串 指针 的 列表 wxChar** 和 数量 代替 .和 wxSingleChoiceDialogP AMZ, AA LE His wah 
提供 客户 区 数据 . 


使 用 函数 SetSelections 还 设置 默认 选中 的 选项 ,其 参数 为 wxArrayInt 类 型 ,代表 一 个 整数 数组 .使 
用 GetSelections 来 获取 用 户 的 选择 ,返回 值 也 为 wxArraylnt 类 型 . 


wxMultiChoiceDialog 使 用 举例 


#include "wx/choicdlg.h" 

const wxArrayString choices; 

choices .Add(wxT("One")); 

choices .Add(wxT("Two")); 

choices.Add(wxT("Three")); 

choices.Add(wxT("Four")); 

choices.Add(wxT("Five")); 

wxMultiChoiceDialog dialog(this, 
wxT("A multi-choice convenience dialog"), 
wxT("Please select several values"), 
choices); 

if (dialog.ShowModal() == wxID_OK) 


wxArrayInt selections = dialog.GetSelections(); 

wxString msg; 

msg.Printf(wxT("You selected %u items:\n"), 
selections.GetCount()); 


for ( size_t n = 0; n &lt; selections.GetCount(); n++ ) 


{ 
msg += wxString::Format(wxT("\t%d: %d (%s)\n"), 
n, selections[n], 
choices[selections[n]].c_str()); 
} 


wxMessageBox(msg, wxT("Got selections")); 


8.4 输入 对 话 框 


这 一 类 对 话 框 让 用 户 自己 输入 信息 ,包括 :wxNumberEntryDialog, wxTextEntryDialog, 
wxPasswordEntryDialog 和 wxFindReplaceDialog. 


wxNumberEntryDialog 


wxNumberEntryDialog 提 示 用 户 输入 一 个 固定 范围 内 的 数字 ,这 个 对 话 框 包 含 一 个 spin 控 件 因 
此 ,用 户 既 可 以 手动 输入 数字 ,也 可 以 通过 鼠标 点 击 spin 按 钮 来 调整 数字 的 值 ,这 个 对 话 框 是 
wxWidgets 自 己 实现 的 ,因此 在 各 个 平台 上 的 表现 都 是 相似 的 . 


创建 wxNumberEntryDialog 需 要 提供 的 参数 包括 一 个 父 窗口 ,消息 文本 ,提示 文本 (显示 在 spin 控 
件 的 前 面 ), 标 题 文本 , 黑 认 值 ,最 小 值 和 最 大 值 ,位 置 等 ,然后 调用 ShowDialog 函 数 ,如 果 返 回 
wxID_OK, 则 可 以 调用 GetValue 画 数 返 回 用 户 输入 的 数字 的 值 . 


下 图 演示 了 其 在 windows 平 台 上 的 样子 : 


Numeric input test 


This is some text, actually a lot of text. 
Even two rows of text. 


Enter a number: | fil] 





wxNumberEntryDialog 使 用 举例 


上 图 中 的 对 话 框 是 用 下 面 的 代码 创建 的 : 


#include "wx/numdlg.h" 

wxNumberEntryDialog dialog(parent, 
wxT("This is some text, actually a lot of text\nEven two rows of text"), 
wxT( "Enter a number:"), wxT("Numeric input test"), 50, ©, 100); 

if (dialog.ShowModal() == wxID_OK) 


long value = dialog.GetValue(); 
} 


wxTextEntryDialog 和 wxPasswordEntryDialog 


wxTextEnTRyDialog 和 wxPasswordEntryDialog 提 供 一 个 消息 文本 和 一 个 单行 文本 框 控件 ,以 
便 用 户 可 以 输入 文本 ,它们 的 功能 很 类 似 ,只 不 过 在 wxPasswordEntryDialog 中 输入 的 文本 被 以 
掩 码 的 方式 显示 ,因此 是 不 能 直接 看 到 的 . 下 图 演示 了 wxTextEntryDialog 对 话 框 在 windows 平 台 
上 的 例子 : 


Please enter a string 


This is a small sample 
Å long, long string to test out the text entrybox 


| Default value 








创建 这 两 个 对 话 框 需要 提供 的 参数 包括 父 窗口 指针 ,消息 文本 ,标题 文本 ,默认 文本 和 一 个 类 型 参 
数 .类 型 参数 是 一 个 比特 位 列表 ,其 值 为 wxOK, wxCANCEL,wxCENTRE( 或 者 wxCENTER) 等 ， 
你 还 可 以 传递 wxTextCtrl 的 窗口 类 型 wxTE_CENTRE( 或 wxTE_CENTER) 等 . 


你 可 以 使 用 SetValue 函 数 单独 设置 其 默认 文本 ,还 可 以 使 用 GetValue 玉 数 获取 用 户 输入 的 文本 . 
wxTextEntryDialog 使 用 举例 


上 图 演示 的 对 话 框 是 用 下 面 的 代码 创建 的 : 


#include "wx/textdlg.h" 

wxTextEntryDialog dialog(this, 
wxT("This is a small sample\n") 
wxT("A long, long string to test out the text entrybox"), 
wxT("Please enter a string"), 
wxT( "Default value"), 
wxOK | wxCANCEL); 

if (dialog.ShowModal() == wxID_OK) 

wxMessageBox(dialog.GetValue(), wxT("Got string")); 


wxFindReplaceDialog 


wxFindReplaceDialog 是 一 个 非 模 式 对 话 框 , 它 允 许 用 户 用 来 输入 用 于 搜索 的 文本 以 及 (如 果 需 

要 的 话 ) 用 来 替换 的 文本 .实际 的 搜索 动作 需要 在 其 派生 类 或 者 其 父 窗口 作为 这 个 对 话 框 某 个 按 
钮 时 间 的 响应 来 完成 .和 大 多 数 标准 对 话 框 不 同 ,这 种 对 话 框 必须 拥有 一 个 父 窗口 ( 非 空 ), 并 且 这 
个 对 话 框 必须 是 非 模式 显示 的 ,无 论 是 基于 设计 还 是 实现 来 说 . 


下 图 演示 了 windows 系 统 上 的 查找 和 替换 对 话 框 : 


Find and replace dialog 


Find what |wiWindows 
Replace with: [wxWidgets 7 7 





Match whole word only 





在 其 它 平台 (比如 GTK+ 或 Mac OS X) 上 , wxWidgets 使 用 自己 实现 的 通用 版 对 话 框 ,如 下 图 所 示 : 


bd Find and replace dialog 





Search for: |wxWindows 
Replace with: [wxWidgets 


四 hole word: Search direction 
[| | © Up 


Match case 
O © Down 








处 理 这 个 对 话 框 相关 的 事件 


wxFindReplaceDialog 对 话 框 在 用 户 点 击 其 上 的 按钮 的 时 候 产 生 一 些 命 合 事 件 .事件 处 理 辑 数 
采用 wxFindDialogEvent 类 型 的 参数 ,事件 映射 宏 中 的 窗口 标识 符 为 这 个 对 话 框 的 标识 符 ,这 些 
宏 如 下 表 所 示 : 


EVT_FIND(id, func) H"a He" tein RR Bat =e E. 
EVT_FIND_NEXT(id, func) 当 " 下 一 个 "按钮 被 按 下 时 产生 . 
EVT_FIND_REPLACE(id, func) 当 " 蔡 换 " 按 钮 被 按 下 时 产生 . 
EVT_FIND_REPLACE_ALL(id， 


xl nm wth rh > 
func) 当 " 蔡 换 全 部 "按钮 被 按 下 时 产生 . 


EVT_FIND_CLOSE(id, func) ge 户 通过 取消 或 者 别 的 途径 关闭 对 话 框 的 时 候 产 


wxFindDialogEventhI Ax A EEX 


GetFlags 返 回 下 列 值 的 一 组 比特 位 列表 :wxFR_DOWN, wxFR_WHOLEWORD 和 
wxFR_MATCHCASE. 


GetFindString 返 回 用 户 输入 的 要 查找 的 文本 . 
GetreplaceString 返 回 用 户 输入 的 要 蔡 换 的 文本 . 
Getdialog 返 回 一 个 指向 产生 这 个 事件 的 对 话 框 的 指针 . 
向 对 话 框 传递 数据 


创建 WxFindReplaceDialog 需 要 传递 的 参数 包括 一 个 父 窗 口 ,一 个 指向 wxFindReplaceData 的 指 
针 , 标 题 文本 和 一 个 类 型 ,类 型 是 下 表 所 示 上 比特 值 的 列表 : 


wxFR_REPLACEDIALOG 引 定 对 话 框 是 查找 替换 对 话 框 ,而 不 是 查找 对 话 框 . 
wxFR_NOUPDOWN 只 是 查找 方向 不 允许 被 改变 . 
wxFR_NOMATCHCASE 支持 仅 允 许 大 小 敏感 的 搜索 或 替换 . 


wxFR_NOWHOLEWORD 指定 不 支持 整 字 搜索 的 选项 . 


wxFindReplaceData 保 存 了 所 有 wxFindReplaceDialog 相 关 的 信息 .用 来 对 
wxFindReplaceDialog 对 象 进 行 初始 化 的 动作 以 及 用 来 在 wxFindReplaceDialog 对 话 框 关闭 以 
后 保存 其 相关 的 信息 , 它 的 值 也 会 在 每 次 产生 wxFindDialogEvent 事 件 的 时 候 自动 更 新 ,因此 你 
可 以 直接 使 用 它 的 成 员 画 数 来 代替 使 用 wxFindDialogEvent 事 件 的 成 员 画 数 .使 用 对 话 框 的 
GetData 函 数 可 以 返回 在 构造 对 话 框 的 时 候 填 充 的 wxFindReplaceData 对 象 指针 . 


wxFindReplaceData 的 成 员 画 数 


下 面 列 出 了 wxFindReplaceData 的 用 来 设置 或 者 获取 相关 数据 的 函数 ,注意 那些 用 于 设置 的 孙 
数 只 在 这 个 对 话 框 显示 之 前 有 用 ,在 对 话 框 显示 以 后 ,调用 这 些 用 于 设置 的 函数 是 没有 任何 效果 
的 . 


GetFindString 和 SetFindString 用 来 设置 或 者 获取 要 查找 的 字符 串 . 

GetFlags 和 SetFlags 用 来 设置 或 者 获取 查找 替换 对 话 框 选项 的 相应 状态 (前 面 已 经 有 具体 描 
述 ). 

GetreplaceString 和 SetReplaceString 用 来 设置 或 者 获取 要 替换 成 的 字符 串 . 
查找 和 蔡 换 使 用 举例 


下 面 演 示 了 查找 和 替换 对 话 框 的 使 用 方法 ,其 中 DoFind 和 DoReplace 本 数 的 代码 没有 列 出 来 , 它 
们 用 来 进行 应 用 程序 相关 的 查找 和 替换 动作 .同时 ,这 些 范 数 还 应 该 维护 一 组 应 用 程序 相关 的 变 
量 ,用 来 保存 当前 查找 的 位 置 ,以 便 下 次 查找 在 这 之 后 进行 ,这 些 函 数 还 应 该 完成 文档 视图 相 匹 配 


部 分 的 高 亮 显示 . 


#include "wx/fdrepdlg.h" 

BEGIN_EVENT_TABLE(MyFrame, wxFrame) 
EVT_MENU(ID_REPLACE, MyFrame: :ShowReplaceDialog) 
EVT_FIND(wxID_ANY, MyFrame: :OnFind) 
EVT_FIND_NEXT(wxID_ANY, MyFrame: :OnFind) 
EVT_FIND_REPLACE(wxID_ANY, MyFrame: :OnReplace) 
EVT_FIND_REPLACE_ALL(wxID_ANY, MyFrame: :OnReplaceA11) 
EVT_FIND_CLOSE(wxID_ANY, MyFrame: :OnFindClose) 

END_EVENT_TABLE( ) 

void MyFrame: :ShowReplaceDialog( wxCommandEvent& event ) 


if ( m_dlgReplace ) 


delete m_dlgReplace; 
m_dlgReplace = NULL; 


} 
else 
m_dlgReplace = new wxFindReplaceDialog 
( 
this, 
&m_findData, 
wxT("Find and replace dialog"), 
wXFR_REPLACEDIALOG 
); 
m_digReplace->Show( true) ; 
} 


void MyFrame: :OnFind(wxFindDialogEvent& event) 


if (!DoFind(event.GetFindString(), event.GetFlags())) 
{ 


} 


void MyFrame: :OnReplace(wxFindDialogEvent& event) 


wxMessageBox(wxT("No more matches.")); 
if (!DoReplace(event.GetFindString(), event.GetReplaceString(), 


event.GetFlags(), REPLACE_THIS) ) 
{ 


} 


void MyFrame: :OnReplaceAll(wxFindDialogEvent& event) 


wxMessageBox(wxT("No more matches.")); 


if (DoReplace(event.GetFindString(), event.GetReplaceString(), 
event.GetFlags(), REPLACE_ALL) ) 


{ 
wxMessageBox(wxT("Replacements made.")); 
} 
else 
{ 
wxMessageBox(wxT("No replacements made.")); 
} 


void MyFrame: :OnFindClose(wxFindDialogEvent& event) 


m_dlgReplace->Destroy(); 
m_dlgReplace = NULL; 


8.5 打印 对 话 框 


你 可 以 使 用 的 打印 对 话 框 包括 wxPageSetupDialog 和 wxPrintDialog 以 用 来 打印 文档 . 不 过 ,如 
果 你 使 用 wxWidgets 的 打印 框架 (包括 wxPrintout, wxPrinter 以 及 其 它 一 些 类 ) 的 话 ,你 的 代码 中 
很 少 需要 显 式 的 调用 这 些 对 话 框 .更 多 关于 打印 的 细节 请 参考 第 5 章 , "绘画 和 打印 ." 


wxPageSetupDialog 


wxPageSetupDialog 包 含 一 些 用 来 设置 纸张 大 小 (A4 或 者 信纸 大 小 等 ), 打 印 方向 (横向 或 者 纵 
向 ), 以 毫米 为 单位 的 边框 大 小 等 控件 还 包括 一 个 用 来 调用 另外 一 个 更 详细 打印 设置 对 话 框 的 按 
FAL. 


下 图 演示 了 wxPageSetupDialog 对 话 框 在 windows 系 统 上 的 样子 : 


Page Setup 


Paper 


Size: 


Source: | Automatically Select 





Orientation Margins [millimeters] 


© Portrait Left: Right: 


o | 
© Landscape Top: 0 Bottom: 








而 下 面 的 这 个 图 则 是 WwxWidgets 自 己 实现 的 使 用 GTK+ 的 通用 的 打印 设置 对 话 框 : 





wxWidgets 跨 平台 GUI 编程 


ba Page Setup 


Paper size 
AA small sheet, 210 x 297 mm 


Orientation 
@) Portrait © Landscape 








Left margin (mm): jo | Right margin (mm): lo | 
Top margin (mm): o | Bottom margin (mm): [o | 














如 果 使 用 了 Gnome 的 打印 库 , 则 GTK 版 本 中 的 打印 设置 对 话 框 将 使 用 Gnome 的 原生 对 话 框 ,如 
下 图 所 示 : 
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Mac 版 本 的 打印 对 话 设置 对 话 框图 下 图 所 示 : 


8.5 打印 对 话 框 232 


Page Setup 











Settings: | Page Attributes E 
Format for: | Any Printer ke 
Paper Size: { A4 ke 


20.99 cm x 29.70 cm 








Orientation: Ve 回 1 d 





Scale: 100 % 








要 创建 一 个 打印 设置 对 话 框 ,你 需要 传递 的 参数 包括 一 个 父 窗口 和 一 个 指向 
wxPageSetupDialogData 对 象 的 指针 ,后 者 用 于 指定 以 及 从 对 话 框 获取 打印 设置 相关 的 数据 ,你 
可 以 以 局 部 变量 或 者 全 局 指针 的 方式 创建 打印 设置 对 话 框 .构造 辑 数 中 的 打印 o 
H n E ENA Se xt SERIA ACHE A, mGetPageSetupData irt MAR ARAE 
置 对话 框 内 部 数据 的 引用 . 


wxPageSetupDatam ” EEX 


OEE CE EE S fs IE 青 况 下 返回 True, 在 windows 平 台 上 ,如 果 没 有 设置 默认 的 打印 机 ， 
这 个 本 数 可 能 返回 False, 在 其 它 平 台 上 ,这 个 函数 总 是 返回 True. 


SetMarginTopLefti pO rat MEF El A MA A BRA LE A E. 
GetMarginTopLeft 则 用 来 获取 这 两 个 边 距 . 


SetMarginBottomRight 函 数 使 用 wxPoint 类 型 的 参数 以 宫 米 为 单位 设置 打印 页 面 的 右边 距 和 下 
边 距 . GetMarginBottomRight 则 用 来 获取 这 两 个 边 距 . 


SetPaperld 使 用 标识 符 来 代替 具体 的 大 小 来 设置 页 面 大 小 . 参考 这 个 函数 在 手册 中 的 描述 来 获 
取 相 关 的 标识 符 . GetPaperld 则 用 来 获取 当前 设置 的 标识 符 . 


SetPaperSize 采 用 一 个 wxSize 参 数 来 设置 以 毫米 为 单位 的 页 面 大 小 . GetPaperSize 则 用 来 获 
取 对 应 的 设置 


EnableMargins 人 允许 或 者 禁用 对 话 框 上 的 边界 控制 控件 ( 仅 适用 于 Windows). 
GetEnableMargins 用 来 获取 这 个 设置 的 值 . 


EnableOrientation 用 来 允许 或 者 禁止 对 话 框 上 的 打印 方向 控制 控件 ( 仅 适用 于 Windows). 
GetEnableOrientation 用 来 获取 这 个 设置 的 值 . 


EnablePaper 用 来 允许 或 者 禁止 对 话 框 上 选择 纸张 大 小 的 控件 ( 仅 适用 于 Windows). 
GetEnablePaper 用 来 获取 这 个 设置 的 值 . 


EnablePrinter 用 来 允许 或 者 禁止 打印 机 按钮 ,这 个 按钮 用 来 调用 另外 一 个 打印 设置 对 话 框 . 
GetEnablePrinter 用 来 获取 这 个 设置 的 值 . 


wxPageSetupDialog 使 用 举例 


#include "wx/printdlg.h" 
void MyFrame: :OnPageSetup(wxCommandEvent& event) 


{ 
wxPageSetupDialog pageSetupDialog(this, & m_pageSetupData) ; 
if (pageSetupDialog.ShowModal() == wxID_OK) 
m_pageSetupData = pageSetupDialog.GetPageSetupData(); 
} 


wxPrintDialog 


这 个 对 话 框 用 来 显 式 打印 及 打印 设置 的 标准 对 话 框 , 当 这 个 对 话 框 关闭 的 时 候 你 可 以 从 中 获得 
一 个 wxPrinterDC 对 象 的 实例 . 


下 图 演示 了 这 个 对 话 框 在 windows 系 统 上 的 外 观 : 


& Print 


General | 





Select Printer 


[al Add Printer Fax cA Linotronic 


cÀ Apple LaserWriter Pro 600 hp deskjet 960c a PDF995 
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4 | > 


Status: Ready [_] Print to file 
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Comment: Find Printer... 
Page Range 
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ection 


© Pages: 1 Collate E 
Enter either a single page number or a single pi pi 
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下 面 的 两 幅 图 分 别 演 示 了 GTK 版 本 中 没有 使 用 Gnome 打 印 库 和 使 用 了 GNome 打 印 库 两 种 情况 
下 对 应 的 这 个 对 话 框 的 样子 : 


wxWidgets 跨 平台 GUI 编程 


Printer: Generic PostScript 
Status: Ready 


Print Range 


© All @ Pages 
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下 图 则 演示 了 Mac OSX 上 对 应 的 样子 ,从 图 中 可 以 看 到 ,Mac 在 标准 对 话 框 中 提供 了 预览 以 及 存 
为 PDF 文 件 的 选项 ,你 可 以 直接 使 用 这 个 预览 功能 . 


Print 


Printer: HPDeskjet960 rey 
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8.5 打印 对 话 框 235 


要 创建 一 个 wxPrintDialog 对 象 ,你 需要 提供 的 参数 包括 一 个 父 窗口 指针 ,一 个 wxPrintDialogData 
对 象 的 指针 , 后 者 的 内 容 将 被 拷贝 给 打印 对 话 框 内 部 的 对 象 .如 果 你 希望 显示 一 个 打印 设置 对 话 
框 来 代替 打印 对 话 框 ,你 可 以 以 True 为 参数 调用 wxPrintDialogData:: SetSetupDialogW 4,” ia 
再 将 其 传递 给 wxPrintDialog 的 构造 画 数 .按照 微软 的 说 法 ,虽然 打印 设置 对 话 框 已 经 被 
wxPageSetupDialog 所 取代 ,但 是 一 些 老 的 程序 可 能 还 在 使 用 以 前 的 标准 ,因此 ,这 样 作 可 以 保证 
兼容 性 . 


打印 对 话 框 被 成 功 关 闭 的 时 候 , 你 可 以 使 用 GetPrintDialogData 函 数 来 获取 一 个 
wxPrintDialogData 的 引用 . 


调用 对 话 框 的 GetPrintDC 辑 数 来 获取 一 个 基于 用 户 选 项 的 打印 设备 上 下 文 ,如 果 这 个 画 数 的 返 
回 值 不 为 空 ,应 用 程序 应 该 自己 释放 这 个 被 返回 的 对 象 . 


Ok 画 数 在 打印 对 话 框 内 部 数据 有 效 的 时 候 返 回 True, 在 windows 平 台 上 ,如 果 没 有 设置 默认 的 打 
印 机 , 则 Ok 返回 False, 在 其 它 平 台 上 ,这 个 图 数 总 是 返回 True. 


wxPrintDialogDatafy Ax A EEX 
EnableHelp 允 许 或 者 禁止 对 话 框 上 的 帮助 按钮 . GetEnableHelp 用 来 获取 对 应 的 设置 . 


EnablePageNumbers 人 允许 或 者 禁止 页 码 设置 控 件 , GetEnablePageNumbers 用 来 获取 对 应 的 


设置 . 
EnablePrintToFile 人 允许 或 者 禁止 打印 到 文件 按钮 . GetEnablePrintToFile 用 来 获取 对 应 的 设置 . 


EnableSelection 人 允许 或 者 禁止 用 于 给 用 户 选 择 打 印 范围 的 单 选 框 . GetEnableSelection 用 来 获 
取 这 个 设置 的 值 . 


SetCollate 用 来 设置 Collate 复 选 框 的 值 为 True 或 者 false. GetCollate 来 获取 这 个 复 选 框 的 值 . 


SetFromPage 和 SetToPage 用 来 设置 打印 的 起 始 页 和 终 至 页 . 使 用 GetFromPage 和 GetToPage 
来 获取 相应 的 值 . 


SetMinPage 和 SetMaxPage 用 来 设置 可 以 打印 的 最 小 页 数 和 最 大 页 数 . GetMinPage 和 
GetMaxPage 则 用 来 获取 相应 的 值 . 


SetNoCopies 用 来 设置 默认 打印 份 数 . GetNoCopies 用 来 获取 当前 设置 的 打印 份 数 . 
SetPrintToFile 设 置 打印 到 文件 的 复 选 框 的 值 . GetPrintToFile 则 用 来 获取 这 个 值 的 当前 设 定 . 
SetSelection 用 来 设置 打印 范围 单 选 框 选项 . GetSelection 则 用 来 返回 这 个 选项 的 值 . 


SetSetupDialog 用 来 指示 显示 打印 设置 对 话 框 还 是 打印 对 话 框 . GetSetupDialog 来 获取 这 个 设 
E. 


SetPrintData 设 置 内 部 的 wxPrintData 对 象 . GetPrintData 则 用 来 返回 内 部 的 wxPrintData 对 象 的 
一 个 引用 . 


wxPrintDialog 使 用 举例 
下 面 的 例子 演示 了 怎样 显示 一 个 打印 对 话 框 以 便 获取 对 应 的 打印 上 下 文 : 


#include "wx/printdlg.h" 
void MyFrame: :OnPrint(wxCommandEvent& event) 
{ 
wxPrintDialogData dialogData; 
dialogData.SetFromPage(0); 
dialogData.SetToPage(10); 
wxPrintDialog printDialog(this, & m_dialogData); 
if (printDialog.ShowModal() == wxID_OK) 
{ 
// 在 调用 GetPrintDC( ) 以 后 ， 应 用 程序 
// 负责 管理 这 个 设备 上 下 文 
wxDC* dc = printDialog.GetPrintDC(); 
// 在 这 个 设备 上 下 文 上 绘画 


// 然后 释放 它 
delete dc; 


不 过 ,通常 你 不 需要 自己 直接 调用 打印 对 话 框 .你 应 该 使 用 wxWidgets 提 供 的 高 层 打 印 框架 ( 参 
考 第 5 章 ). 在 你 调用 wxPrinter::Print 函 数 的 时 候 将 会 自动 显示 打印 对 话 框 . 


第 八 章 小 结 


在 这 一 章 里 ,你 学 习 了 怎样 使 用 标准 对 话 框 ,以 便 通 过 很 少 的 代码 来 向 你 的 用 户 提供 信息 或 者 从 
用 户 那 里 获得 输入 .关于 更 多 使 用 标准 对 话 框 的 例子 ,你 可 以 参考 WxWidgets 自 带 的 
samples/dialogs 中 的 例子 .在 下 一 章 中 ,我 们 会 介绍 一 下 怎样 创建 你 自己 的 对 话 框 . 


第 九 章 创 建 定制 的 对 话 框 


也 许 很 快 ,也 许 在 将 来 什么 时 候 ,你 就 需要 创建 你 自己 的 对 话 框 .也 许 只 是 很 简单 的 拥有 一 些 按钮 
或 者 文本 的 对 话 框 ,也 许 是 很 复 末 的 包含 notebook 控 件 , 多 面板 ,定制 控件 并 且 拥 有 上 下 文敏 感 
帮助 的 对 话 框 等 .在 这 一 章 里 ,我 们 将 介绍 创建 定制 的 对 话 框 以 及 将 数据 在 对 话 框 控件 和 C++ 变 
量 之 间 传 输 的 一 般 原理 .我 们 还 会 介绍 一 下 wxWidgets 的 资源 管理 体系 ,这 个 体系 允许 你 从 XML 
文件 中 加 载 并 创建 对 话 框 或 者 是 其 它 的 用 户 界面 . 


9.1 创建 定制 对 话 框 的 步骤 


当 你 开始 创建 你 自己 的 对 话 框 的 时 候 , 真 正 有 趣 的 事情 才 算 是 刚刚 开始 .下 面 是 通常 你 需要 采取 
的 步骤: 


从 wxDialog 派 生 一 个 新 类 . 

决定 数据 的 存放 位 置 以 及 应 用 程序 以 怎样 的 方式 访问 用 户 选 择 的 数据 . 

编写 代码 来 创建 和 布局 相关 控件 . 

增加 代码 以 便 在 C++ 变 量 和 控件 之 间 进 行 数据 传输 . 

增加 事件 映射 和 相应 的 处 理 函 数 以 处 理 那 些 来 自控 件 的 事件 . 

增加 用 户 界面 更 新 处 理 罚 数 ,以 便 将 控件 设置 为 正确 的 状态 . 

增加 帮助 ,尤其 是 工具 提示 以 及 上 下 文敏 感 帮助 (在 Mac OS 中 还 没有 实现 ), 以 及 在 你 的 应 用 
程序 的 用 户 手册 中 添加 你 的 对 话 框 的 使 用 方法 . 

8. 在 你 的 应 用 程序 中 调用 你 定制 的 对 话 框 . 


NQOa FF WN > 


让 我 们 通过 一 个 具体 的 例子 来 说 明 一 下 这 些 步骤 . 


9.2 一 个 例子 :PersonalRecordDialog 


正如 我 们 在 前 面 的 章节 看 到 的 那样 ,对 话 框 通常 有 两 种 :模式 对 话 框 和 非 模式 对 话 框 .我 们 将 创建 
一 个 定制 的 模式 的 对 话 框 ,因为 这 是 最 常用 的 一 种 对 话 框 ,而 且 需 要 注意 的 方面 也 会 更 少 .因为 应 
用 程序 调用 ShowModal 函 数 以 后 ,直到 这 个 函数 返回 ,占用 程序 将 禁止 除了 这 个 窗口 以 及 这 个 窗 
口 产 生 的 别 的 模式 对 话 框 窗口 以 外 的 所 有 别 的 窗口 处 理 任何 用 户 输入 ,而 将 所 有 的 用 户 交互 限 
制 在 我 们 这 个 模式 对 话 框 的 小 世界 里 面 . 


创建 一 个 自 定义 对 话 框 的 许多 步骤 ,可 以 通过 使 用 一 个 对 话 框 编辑 器 而 变 得 简单 .比如 
wxDesigner 或 者 DialogBlocks ( 译 者 注 :当然 ,它们 都 是 收费 的 .一 个 不 收费 的 开源 的 对 话 框 编辑 
器 是 WxGlade, 效 果 好 像 也 不 错 ). 如 果 使 用 了 对 话 框 编辑 器 ,那么 剩余 的 需要 你 自己 写 代 码 的 部 
分 的 复 条 程度 将 和 你 的 对 话 框 的 复 末 程序 相关 .不 过 在 这 里 ,我 们 将 以 全 部 手写 的 方式 创建 这 个 
对 话 框 ,以 便于 演示 创建 定制 对 话 框 的 一 些 基本 原理 ,但 是 我 们 强烈 推荐 你 使 用 任何 一 种 对 话 框 
编辑 器 因为 它 将 节省 你 大 量 的 时 间 . 


我 们 将 通过 这 样 的 一 个 对 话 框 来 演示 创建 自 定 义 对 话 框 的 步 又: 用 户 需要 使 用 这 个 对 话 框 输入 
它 的 姓名 ,年 龄 和 性 别 以 及 它 是 否 想 投票 .这 个 对 话 框 叫做 PersonalRecordDialog, 它 的 样子 如 下 
所 示 : 
«= Personal Record 
Please enter your name, age and sex, and specify whether you wish to 


vote in a general election. 


Name: 


Female v Vote 


Reset Cancel Help 





其 中 的 Reset 按 钮 将 所 有 控件 的 值 复位 到 它们 的 黑 认 值 .Ok 按 钮 关闭 对 话 框 并 且 以 wxID_OK 值 
从 ShowModal 函 数 返回 . Cancel 按 钮 关闭 对 话 框 并 且 以 wxlID_CANCEL 值 从 ShowModal 函 数 
返回 ,也 不 会 用 用 户 输入 的 值 来 更 新 对 话 框 的 内 部 变量 .而 Help 按 钮 则 显示 一 段 文本 用 来 大 概 描 
述 这 个 对 话 框 (当然 ,在 实际 的 程序 中 ,这 个 按钮 应 该 调用 一 个 更 漂亮 的 格式 化 过 的 帮助 文件 ). 


一 个 好 的 用 户 界面 应 该 不 允许 用 户 进行 当前 上 下 文中 不 允许 的 操作 .在 这 个 例子 中 ,如 果 年 龄 的 
值 小 于 18, 则 投票 按钮 应 该 是 不 可 用 的 (根据 英国 或 者 美国 的 法 律 ). 


派生 一 个 新 类 


下 面 的 代码 定义 了 这 个 新 的 对 话 框 类 :PersonalRecordDialog, 我 们 使 用 DECLARE_CLASS 宏 
来 提供 运行 期 类 型 信息 ,而 使 用 DECLARE_EVENT_TABLE 宏 来 定义 了 一 个 事件 表 


aia 
* PersonalRecordDialog 类 定义 
Sf/ 
class PersonalRecordDialog: public wxDialog 


DECLARE_CLASS( PersonalRecordDialog ) 
DECLARE_EVENT_TABLE( ) 
public: 
// 4ER 
PersonalRecordDialog( ); 
PersonalRecordDialog( wxwWindow* parent, 
wxWindowID id = wxID_ANY, 
const wxString& caption = wxT("Personal Record"), 
const wxPoint& pos = wxDefaultPosition, 
const wxSize& size = wxDefaultSize, 
long style = wxCAPTION|wxRESIZE_BORDER|wxSYSTEM_MENU ); 
// 用 来 初始 化 内 部 变量 
void Init(); 
// 创建 窗 体 
bool Create( wxWindow* parent, 
wxWindowID id = wxID_ANY, 
const wxString& caption = wxT("Personal Record"), 
const wxPoint& pos = wxDefaultPosition, 
const wxSize& size = wxDefaultSize, 
long style = wxCAPTION|wxRESIZE_BORDER|wxSYSTEM_MENU ); 
// 创建 普通 控件 和 布局 控件 
void CreateControls(); 


en 

依照 wxWidgets 的 惯例 ,我 们 同时 支持 了 单 步 创建 和 两 步 窗口 的 方式 , 单 步 创 建 使 用 的 是 一 个 复 
条 的 构造 本 数 ,而 两 步 创 建 则 使 用 的 是 一 个 简单 的 额 构 造 画 数 和 一 个 复 末 的 Create 本 数 . 
设计 数据 存储 


我 们 有 四 个 数据 要 存储 :姓名 (字符 串 ), 年 龄 (整数 ), 性 别 (bool) 和 是 否 投票 (bool). 因 为 我 们 想 用 选 
择 框 来 作为 性 别 的 用 户 界 面 ,所 以 我 们 将 性 别 的 类 型 更 改 为 整数 类 型 ,但 是 它 可 以 对 外 表现 为 
bool 类 型 . 现在 让 我 们 来 给 PersonalRecordDialog 类 增加 这 些 成 员 : 


// 数据 成 员 

wxString m_name; 
int m_age; 
int m_sex; 
bool m_vote; 


// 姓名 访问 控制 

void SetName(const wxString& name) { m_name = name; } 
wxString GetName() const { return m_name; } 

// 年 龄 访问 控制 

void SetAge(int age) { m age = age; } 

int GetAge() const { return m_age; } 

// 性 别 访问 控制 (男性 = false, KM = true) 

void SetSex(bool sex) { sex ? m_sex = 1 : m_sex = 0; } 
bool GetSex() const { return m_sex == 1; } 

// BARR? 

void SetVote(bool vote) { m_vote = vote; } 

bool GetVote() const { return m_vote; } 


编码 产生 控件 和 布局 


现在 我 们 增加 一 个 CreateControls 画 数 来 创建 控件 ,这 个 函数 将 被 Create 画 数 调 用 , 它 将 增加 一 
个 静态 文本 框 ,按钮 ,一 个 wxSpinCtrl 控 件 和 一 个 wxTextCtrl 控 件 ,一 个 wxChoice 控 件 , 一 个 
WwWxCheckBox 控 件 ,参见 上 图 中 的 最 终 效果 . 


我 们 使 用 了 布局 控件 来 进行 布局 ,这 是 为 什么 它 比 你 想像 中 的 显得 复杂 了 一 点 的 原因 (你 应 该 还 
记得 布局 控件 ,我 们 在 第 7 章 对 齐 进行 了 描述 , 简 ee ee ae ai iB 
言 以 及 平台 的 变化 而 变化 的 能 力 ). 当 然 你 也 可 以 使 用 别 的 方法 来 进行 布局 ,比如 你 可 以 使 用 从 
wxWidgets 资 源 文 件 (XRC) 中 读 取 布局 的 方法 . 


我 们 来 大 概 刷 新 一 下 你 关于 布局 控件 的 记忆 ,布局 控件 把 所 有 的 控件 分 为 一 个 一 个 的 小 格子 ,每 
个 格子 刚好 可 以 放置 一 个 控件 ,这 些 控件 虽然 可 以 拥有 非常 复杂 的 布局 继承 关系 ,但 是 它们 的 窗 
口 继承 关系 非常 单纯 ,都 是 继承 自 同一 个 父 窗口 .你 可 以 参考 第 7 章 中 的 第 二 幅 图 来 刷新 你 的 记 

忆 . 


在 CreateControls 函 数 中 ,我 们 使 用 了 一 个 垂直 盒子 布局 控件 敬 套 了 另外 一 个 垂直 盒子 布局 控 
件 以 便 使 对 话 框 产生 边界 .一 个 水 平 的 盒子 布局 控件 用 来 放置 wxSpinCtrl, wxChoice 和 
WwWXxCheckBox, 以 及 另外 一 个 水 平 盒子 布局 控件 来 放置 四 个 按钮 . 


Ips] 
* PersonalRecordDialog 控 件 创建 
af 
void PersonalRecordDialog: :CreateControls() 
{ 
// 一 个 顶层 的 布局 控件 
wxBoxSizer* topSizer = new wxBoxSizer (wxVERTICAL ) ; 
this->SetSizer(topSizer); 
// 第 二 个 顶层 布局 控件 用 来 产生 边界 
wxBoxSizer* boxSizer = new wxBoxSizer (wxVERTICAL ); 
topSizer->Add(boxSizer, ©, wxALIGN_CENTER_HORIZONTAL|wxALL, 5); 
// 一 个 友善 的 提示 文本 
wxStaticText* descr = new wxStaticText( this, wxID_STATIC, 
wxT("Please enter your name, age and sex, and specify whether you wish to\nvote i 
a general election."), wxDefaultPosition, wxDefaultSize, © ); 
boxSizer->Add(descr, ©, wxALIGN_LEFT|wxALL, 5); 
// 空格 
boxSizer->Add(5, 5, ©, wxALIGN_CENTER_HORIZONTAL|wWxALL, 5); 
// 产生 静态 文本 
wxStaticText* nameLabel = new wxStaticText ( this, wxID_STATIC, 
wxT("&Name:"), wxDefaultPosition, wxDefaultSize, © ); 
boxSizer->Add(nameLabel, ©, wxALIGN_LEFT|wxALL, 5); 
// 一 个 用 于 输入 用 户 名 的 文本 框 
wxTextCtrl* nameCtrl = new wxTextCtrl ( this, ID_NAME, wxT("Emma"), wxDefaultPosition 
wxDefaultSize, © ); 
boxSizer->Add(nameCtr1l, ©, wxGROW|wxALL, 5); 
// 一 个 水 平 布局 控件 用 来 放 证 年 龄 , 性别 和 是 否 投标 
wxBoxSizer* ageSexVoteBox = new wxBoxsizer(wxHORIZONTAL ) ; 
boxSizer ->Add(ageSexVoteBox, ©, wxGROW|wxALL, 5); 
// 年 龄 控件 的 标签 
wxStaticText* ageLabel = new wxStaticText ( this, wxID_STATIC, 
wxT("&Age:"), wxDefaultPosition, wxDefaultSize, © ); 
ageSexVoteBox->Add(ageLabel, ©, wxALIGN_CENTER_VERTICAL|wxALL, 5); 
// 用 于 输入 年 龄 的 spin 控 件 
wxSpinCtr1* ageSpin = new wxSpinCtrl ( this, ID_AGE, 
wxEmptyString, wxDefaultPosition, wxSize(60, -1), 
wxSP_ARROW_KEYS, 0, 120, 25 ); 
ageSexVoteBox->Add(ageSpin, ©, wxALIGN_CENTER_VERTICAL|wxALL, 5); 
// 性 别 标签 
wxStaticText* sexLabel = new wxStaticText ( this, wxID_STATIC, 
wxT("&Sex:"), wxDefaultPosition, wxDefaultSize, © ); 
ageSexVoteBox->Add(sexLabel, ©, wxALIGN_CENTER_VERTICAL|wxALL, 5); 


// 性 别 选择 框 
wxString sexStrings[] = { 
wxT("Male"), 
wxT("Female" ) 
J; 
wxChoice* sexChoice = new wxChoice ( this, ID_SEX, 
wxDefaultPosition, wxSize(80, -1), WXSIZEOF(sexStrings), 
sexStrings, 0 ); 
sexChoice->SetStringSelection(wxT("Female")); 
ageSexVoteBox->Add(sexChoice, ©, wxALIGN_CENTER_VERTICAL|wxALL, 5); 
// 增加 一 个 可 拉 升 的 空白 区 域 
// 以 便 让 投票 选项 出 现在 右边 
ageSexVoteBox->Add(5, 5, 1, wxALIGN_CENTER_VERTICAL|wxALL, 5); 
wxCheckBox* voteCheckBox = new wxCheckBox( this, ID_VOTE, 
wxT("&Vote"), wxDefaultPosition, wxDefaultSize, © ); 
voteCheckBox ->SetValue(true); 
ageSexVoteBox->Add(voteCheckBox, 0, 
wxALIGN_CENTER_VERTICAL |wxALL, 5); 
// 0K 和 Cancel 按 钮 之 间 的 分 割 线 
wxStaticLine* line = new wxStaticLine ( this, wxID_STATIC, 
wxDefaultPosition, wxDefaultSize, wxLI_HORIZONTAL ); 
boxSizer->Add(line, ©, wxGROW|wxALL, 5); 
// 用 来 放置 四 个 按钮 的 水 平 盒子 布局 控件 
wxBoxSizer* okCancelBox = new wxBoxSizer(wxHORIZONTAL ) ; 
boxSizer->Add(okCancelBox, ©, wxALIGN_CENTER_HORIZONTAL |wxALL, 5); 
// Reset 按 钮 
wxButton* reset = new wxButton( this, ID_RESET, wxT("&Reset"), 
wxDefaultPosition, wxDefaultSize, 0 ); 
okCancelBox->Add(reset, ©, wxALIGN_CENTER_VERTICAL|wxALL, 5); 
// Ok 按钮 
wxButton* ok = new wxButton ( this, wxID_OK, wxT("&0K"), 
wxDefaultPosition, wxDefaultSize, 0 ); 
okCancelBox->Add(ok, ©, wxALIGN_CENTER_VERTICAL|wxALL, 5); 
// Cancel 按 钮 
wxButton* cancel = new wxButton ( this, wxID_CANCEL, 
wxT("&Cancel"), wxDefaultPosition, wxDefaultSize, © ); 
okCancelBox->Add(cancel, ©, wxALIGN_CENTER_VERTICAL|wxALL, 5); 
// He1p 按 钮 
wxButton* help = new wxButton( this, wxID_HELP, wxT("&Help"), 
wxDefaultPosition, wxDefaultSize, 0 ); 
okCancelBox->Add(help, ©, wxALIGN_CENTER_VERTICAL|wxALL, 5); 


} 
| 
数据 传输 和 验证 


现在 我 们 已 经 大 概 建立 起 来 了 这 个 对 话 框 , 但 是 控件 和 它 的 内 部 成 员 还 没有 连接 起 来 ,怎样 完 
这 种 连接 呢 ? 


当 对 话 框 第 一 次 显示 的 时 候 ,wxWidgets 会 调用 InitDialog 函 数 , 这 个 画 数 产生 一 个 
wxEVT_INIT_DIALOG 事 件 .这 个 事件 默认 的 处 理 画 数 是 调用 transferDataToWindow 函 数 .要 把 
数据 从 控件 传 回 变量 中 ,你 可 以 在 用 户 确认 输入 的 时 候 调 用 transferDataFromWindowly 

数 ,wxWidgets 定 义 了 一 个 默认 的 wxID_OK 命 合 事 件 的 处 理 函 数 ,这 个 函数 会 在 EndModal 函 数 
调用 之 前 调用 transferDataFromWindow 男 数 . 


此 ,你 可 以 通过 重 载 transferDataToWindow 和 transferDataFromWindow 函 数 以 实现 数据 传 
输 , 对 于 我 们 这 个 对 话 框 来 说 ,你 可 以 使 用 象 下 面 这 样 的 代码 : 


/*! 


* 传输 数据 到 控件 
wf 
bool PersonalRecordDialog: : TransferDataToWindow( ) 
{ 
wxTextCtr1* nameCtrl = (wxTextCtr1*) FindWindow(ID_NAME) ; 
wxSpinCtrl* ageCtrl = (wxSpinCtr1*) FindWindow(ID_SAGE) ; 
wxChoice* sexCtrl = (wxChoice*) FindWindow(ID_SEX); 
wxCheckBox* voteCtrl = (wxCheckBox*) FindWindow(ID_VOTE) ; 
nameCtr1->SetValue(m_name) ; 
ageCtrl1->SetValue(m_age); 
sexCtrl->SetSelection(m_sex); 
voteCtrl->SetValue(m_vote); 
return true; 
} 
/*! 
* 传输 数据 到 变量 
WH 
bool PersonalRecordDialog::TransferDataFromwindow( ) 
{ 
wxTextCtrl* nameCtrl = (wxTextCtrl*) Findwindow(ID_NAME); 
wxSpinCtrl* ageCtrl = (wxSpinCtr1*) Findwindow(ID_SAGE); 
wxChoice* sexCtrl = (wxChoice*) FindWindow(ID_SEX); 
wxCheckBox* voteCtrl = (wxCheckBox*) FindWindow(ID_VOTE); 
m_name = nameCtr1->GetValue(); 
m_age = ageCtrl->GetValue(); 
m_sex = sexCtrl->GetSelection(); 
m_vote = voteCtrl->GetValue(); 
return true; 
} 


然而 ,还 有 一 个 更 容易 的 方法 .wxWidgets 支 持 验 证 器 ,所 谓 验 证 器 是 一 个 把 数据 变量 和 对 应 的 控 
件 联系 起 来 的 对 象 .虽然 不 总 是 可 以 使 用 ,但 是 只 要 可 以 使 用 ,总 是 可 以 节省 你 大 量 的 时 间 和 代码 
来 进行 数据 的 传输 和 验证 .在 我 们 这 个 例子 中 ,我 们 可 以 通过 下 面 的 代码 来 代替 上 面 的 额 两 个 画 
数 : 


Findwindow(ID_NAME)->SetValidator( 
wxTextValidator(wxFILTER_ALPHA, & m_name)); 
FindWindow(ID_AGE) ->SetValidator ( 
wxGenericValidator(& m_age)); 
FindWindow(ID_SEX) ->SetValidator ( 
wxGenericValidator(& m_sex); 
FindwWindow(ID_VOTE) ->SetValidator( 
wxGenericValidator(& m_vote); 


E JAI axa LER BR EY SY, EH — a 
这 样 守 代码 还 将 增加 校 验 以 便 用 户 不 可 以 在 姓名 框 中 输入 数字 . 


验证 器 可 以 执行 两 个 任务 ,除了 可 以 传输 数据 ,它们 还 可 以 对 数据 进行 校 验 .并 且 在 数据 不 合法 的 
时 候 进 行 错误 提示 .在 这 个 例子 中 ,除了 姓名 框 以 外 , 别 的 输入 控件 都 没有 设置 校 

验 .WxGenericValidator 是 一 个 很 简单 的 验证 器 , 它 只 负责 传输 数据 ,不 对 数据 进行 校 验 ,也 正 因为 
如 此 , 它 支 持 更 多 的 基本 控件 . 别 的 验证 器 则 象 wxTextValidator 一 样 ,提供 了 各 种 的 校 验方 法 , 比 
如 wxTextValidator 就 可 以 阻止 那些 不 合法 的 按键 事件 传 入 文本 框 控 件 .在 这 个 例子 中 ,我 们 只 是 
使 用 了 标准 校 验 类 型 wxFILTER_ALPHA, 但 是 通过 验证 器 的 Setlncludes 和 SetExcludesEHRX, 
我 们 还 可 以 指定 具体 哪些 字符 是 允许 的 哪些 是 不 允许 的 . 


我 们 还 需要 上 略微 深入 一 点 的 来 讨论 WxWidgets 怎 样 处 理 验证 过 程 以 便 你 更 好 的 理解 这 儿 到 底 发 
生 了 什么 .正如 我 们 看 到 的 那样 ,默认 的 OnOKk 画 数 调用 了 TransferDataToWindow 男 数 , 但 是 在 
调用 这 个 画 数 之 前 , 它 还 调用 了 另外 一 个 函数 Validate, 下 面 的 代码 是 默认 的 OnOK 的 代码 : 


void wxDialog: :OnOK(wxCommandEvent& event) 


if ( Validate() && TransferDataFromWindow() ) 


{ 
if ( IsModal() ) 
EndModal(wxID_OK); // 如 果 是 模式 对 话 框 
else 
SetReturnCode(wxID_OK); 
this->Show(false); // 如 果 是 非 模式 对 话 框 
} 
} 


} 


而 默认 的 Validate 画 数 的 实现 是 通 历 对 话 框 所 有 的 直接 子 窗口 (如 果 设置 了 
wxWS_EX_VALIDATE_RECURSIVELY 类 型 的 化 ,也 会 调用 子 窗口 的 子 窗口 ), 依 次 调用 它们 的 
Validate 画 数 ,如 果 任 何 一 个 调用 失败 , 则 整个 Validate 过 程 失 败 ,那么 对 话 框 将 不 会 被 关闭 ,并 且 
验证 器 自己 会 提供 一 个 消息 框 以 说 明和 失败 的 原因 ，. 


类 似 的 ,TransferDataToWindow 和 TransferDataFromWindow 也 将 自动 调用 所 有 子 控件 的 对 应 
的 函数 .一 个 验证 器 可 以 不 做 校 验 ,但 是 必须 要 可 以 支持 作 数 据 传输 . 


一 个 验证 器 其 实 是 一 个 事件 处 理 类 ,wxWidgets 的 事件 处 理 机 制 在 将 事件 传递 给 控件 本 身 之 前 ， 
会 检查 这 个 控件 是 否 被 设置 了 验证 器 ,如 果 已 经 设置 了 , 则 首先 将 这 个 事件 传递 给 验证 器 ,以 便 验 
证 器 可 以 通过 Veto 等 方法 阻止 不 合法 的 按键 事件 .在 这 种 情况 下 ,通常 验证 器 应 该 调用 Beep 画 数 
发 出 一 声 告警 信号 以 便 提 示 用 户 某 个 键 已 经 被 按 下 了 但 是 是 非法 的 . 


wxWidgets 提 供 的 两 种 验证 器 可 能 是 不 足够 的 ,尤其 是 在 你 想 创建 自己 的 控件 的 时 候 , 这 种 情况 
下 你 可 能 希望 能 够 创建 自己 的 验证 器 . 你 需要 从 wxValidator 类 派生 一 个 新 类 ,这 个 新 类 必须 带 有 
一 个 自 拷贝 的 构造 画 数 和 一 个 Clone 玉 数 用 来 返回 自己 的 一 份 拷贝 ,还 要 实现 自己 的 数据 传输 和 
验证 机 制 .通常 一 个 验证 器 都 需要 存储 一 个 指向 某 个 C++ 变 量 的 指针 ,并 且 构 造 画 数 中 人 允许 指定 
不 同 的 模式 以 实现 不 同 的 验证 机 制 .你 可 以 参考 wxWidgets 源 代码 中 的 include/wx/valtext.h 文 
件 和 src/common/valtext.cpp 文 件 以 了 解 怎 样 实现 一 个 自己 的 验证 器 ,也 可 以 参考 第 12 章 ," 高 级 
窗口 类 "中 的 "制作 你 自己 的 控件 "这 一 小 节 . 


处 理事 件 


在 这 个 例子 中 ,wxWidgets 默 认 的 处 理 对 于 OK 和 Cancel 按 钮 来 说 已 经 是 足够 ,不 需要 额外 添加 
任何 代码 ,只 需要 将 其 设置 为 对 应 的 wxID_OK 和 wxID_CANCEL 的 标识 符 . 不 过 ,在 自 定义 对 话 框 
中 ,进行 相应 的 事件 处 理 是 很 经 常 的 事情 .在 这 个 例子 中 我 们 还 有 一 个 Reset 按 钮 , 当 这 个 按钮 被 
点 击 时 ,我 们 需要 复位 所 有 控件 的 值 为 它们 的 默认 值 .因此 我 们 需要 增加 OnResetClick 事 件 处 理 
函数 ,以 及 一 个 对 应 的 事件 表 条 目 . 这 个 处 理 画 数 的 实现 是 非常 简单 的 ,首先 我 们 调用 我 们 自 定 
义 的 Init 成 员 函 数 来 初始 化 所 有 的 成 员 , 然 后 调用 TransferDataToWindow 辑 数 将 数据 传输 到 控 
件 , 如 下 所 示 : 


BEGIN_EVENT_TABLE( PersonalRecordDialog, wxDialog ) 
EVT_BUTTON( ID_RESET, PersonalRecordDialog: :OnResetClick) 


END_EVENT_TABLE( ) 
void PersonalRecordDialog: :OnResetClick( wxCommandEvent& event ) 


Init(); 
TransferDataTowindow( ); 
} 
处 理 UI| 更 新 


GUI 程序 员 设 计 代码 的 一 大 挑战 是 确保 所 有 控件 在 其 不 可 用 的 时 候 都 是 被 茶 用 的 .没有 什么 比 
弹出 一 个 对 话 框 告诉 用 户 "这 个 按钮 目前 是 不 可 用 的 "更 能 破坏 程序 的 紧凑 性 的 了 .如 果 一 个 选 
项 是 不 可 用 的 ,那么 它 看 上 去 就 应 该 是 不 可 用 的 ,用 户 点 击 它 或 者 对 它 进 行 任何 输入 应 该 都 是 没 
有 效果 的 .因此 ,我 们 应 该 在 这 种 情况 发 生 的 时 候 , 尽 可 能 快 的 更 新 控件 的 状态 使 其 不 可 用 或 者 重 
新 可 用 . 


在 我 们 这 个 例子 里 面 ,如 果 用 户 输入 的 年 龄 小 于 18 岁 ,我 们 必须 禁用 投票 按钮 ,使 得 这 个 选项 对 
用 户 来 说 是 不 可 用 的 .你 的 第 一 想法 可 能 是 要 增加 一 个 对 于 spin 控 件 的 事件 的 更 新 事件 处 理 隙 
数 ,并 且 在 其 中 根据 它 的 值 来 禁用 或 者 可 用 投票 复 选 框 控 件 .当然 ,对 于 简单 的 情况 来 说 ,这 样 作 
完全 没有 问题 但 是 试想 一 下 ,如 果 有 很 多 种 控件 存在 这 种 复杂 的 关联 ,或 者 更 坏 的 情况 ,有 时 候 我 
们 根本 不 可 能 在 影响 某 个 控件 的 条 件 发 生 改变 的 时 候 获得 事件 通知 ,比如 说 我 们 的 剪贴 按钮 ,可 
能 要 随 着 剪贴 板 的 有 无 数据 情况 来 进行 可 用 或 者 不 可 用 的 操作 ,而 剪贴 板 是 系统 变量 , 它 可 能 受 
别 的 应 用 程序 的 影响 ,因为 我 们 自己 的 应 用 程序 很 难 在 其 发 生 改 变 的 时 候 收 到 通知 事件 .这 种 情 
况 下 唉 该 怎么 办 呢 ? 


为 了 解决 这 个 问题 ,wxWidgets 提 供 了 一 个 称 为 wxUpdateUIEvent 的 事件 类 ,这 个 事件 实在 系统 
空闲 的 时 候 ( 所 有 其 它 的 事件 都 已 经 处 理 完 的 时 候 ) 发 送 给 应 用 程序 的 .你 可 以 使 用 
EVT_UPDATE_UI 宏 来 拦截 这 个 事件 ,对 应 于 每 一 个 要 和 别 的 控件 关联 改变 状态 的 控件 ,你 需要 
在 事件 表 中 对 应 增加 一 个 条 目 , 每 一 个 对 应 的 处 理 函 数 中 ,可 以 检测 这 个 世界 当前 的 状况 ,从 而 改 
变 某 个 控件 当前 的 状态 :允许 或 者 禁止 ,选中 或 者 未 选中 等 , 这 种 机 制 允 许 你 将 某 个 控件 相关 的 
所 有 因素 在 某 个 特定 的 时 机 放 在 一 个 函数 中 钦 理 .你 可 以 松 一 口气 了 ,因为 你 不 必 记 住 在 每 一 个 
相关 连 的 事件 发 生 改变 的 时 候 去 更 新 对 应 的 控件 了 . 


下 面 是 我 们 用 来 处 理 UI 更 新 事件 的 相关 代码 ,要 注意 在 代码 中 我 们 不 能 直接 判断 m_age 成 员 , 因 
为 这 个 成 员 只 有 在 用 户 点 击 了 OK 按钮 以 后 才 会 将 控件 的 数据 传递 过 来 . 


BEGIN_EVENT_TABLE( PersonalRecordDialog, wxDialog ) 


EVT_UPDATE_UI( ID_VOTE, PersonalRecordDialog: :OnVoteUpdate ) 





END_EVENT_TABLE( ) 
void PersonalRecordDialog: :OnVoteUpdate( wxUpdateUIEvent& event ) 


wxSpinCtrl* ageCtrl = (wxSpinCtr1*) FindWindow(ID_AGE) ; 
if (ageCtrl->GetValue() &lt; 18) 


event .Enable(false); 
event .Check(false); 


else 
event.Enable(true); 


会 不 会 有 大 量 的 这 种 界面 更 新 事件 而 导致 程序 的 性 能 降低 呢 ? 首 先 ,这 种 情况 是 存在 的 ,不 过 你 
不 必 过 分 担心 这 个 问题 ,wxWidgets 已 经 作 了 大 量 的 优化 工作 ,使 得 这 种 系统 开销 将 至 了 最 低 点 . 
不 过 如 果 你 的 程序 真 的 对 性 能 有 很 大 的 要 求 并 且 真 实感 觉 是 因为 这 个 界面 更 新 的 原因 导致 损 
失 了 性 能 ,你 还 是 可 以 通过 wxUpdateUIEvent 相 关 文 档 中 提 到 的 SetMode 画 数 和 
SetUpdatelnterval 函 数 来 对 这 种 行为 进行 进一步 的 控制 , 以 减少 界面 更 新 事件 的 消耗 的 时 间 . 


增加 帮助 信息 
至 少 有 三 种 帮助 信息 你 可 以 给 你 的 对 话 框 提供 . 


e 工具 提示 
e 上 下 文敏 感 帮助 
o 联机 帮助 


当然 ,你 还 可 以 使 用 更 多 更 先进 的 没有 被 wxWidgets 显 式 支持 的 技术 . 我 们 已 经 在 对 话 框 上 边 放 
置 了 一 段 用 来 大 概 描述 这 个 对 话 框 用 途 的 文本 ,对 于 更 复 末 的 对 呼 框 来 说 ,你 可 以 考虑 使 用 
wxHtmlWindow 代 蔡 普 通 的 文本 以 便 可 以 加 载 一 个 HTML 文 件 来 提供 更 复杂 的 帮助 信息 .或 者 ， 
你 还 可 以 在 每 个 按钮 旁边 放置 一 个 小 按钮 用 来 提供 针对 性 的 帮助 信息 . 


下 面 我 们 来 说 一 说 wxWidgets 明 确 支持 的 三 种 帮助 形式 : 

工具 提示 

工具 提示 是 在 鼠标 划 过 某 个 控件 的 时 候 弹 出 的 一 个 小 窗口 ,窗口 里 包含 对 这 个 控件 用 途 的 一 个 
简短 的 提示 .你 可 以 使 用 SetToolTip 郴 数 来 设置 控件 对 应 的 工具 提示 .不 过 ,由 于 对 于 一 些 有 经 验 
的 使 用 者 来 说 ,这 个 提示 可 能 会 显得 有 些 讨 厌 ,因此 你 应 该 给 你 的 应 用 程序 增加 一 个 全 局 的 设置 
以 便 不 显示 这 些 工 具 提 示 ( 这 里 的 意思 是 说 ,这 个 设置 使 得 在 对 话 框 创建 的 时 候 不 调用 
SetToolTip 2). 


上 下 文敏 感 帮助 


上 下 文敏 感 帮 助 提供 的 弹出 窗口 和 工具 提示 窗口 是 非常 相似 的 ,不 过 这 个 窗口 并 不 会 自动 探 出 
来 ,而 需要 用 户 在 点 击 了 某 个 特殊 按钮 以 后 再 点 击 对 应 的 控件 ,或 者 在 某 个 控件 获得 焦点 的 时 候 
按 F1 键 (windows 平 台 适 用 ) 的 时 候 才 会 弹出 .在 windows 平 台 上 ,你 可 以 在 创建 对 话 框 的 时 候 指 


定 wxDIALOG_EX_CONTEXTHELP 类 型 以 便 在 标题 栏 上 出 现 这 个 上 下 文敏 感 帮助 按钮 ,在 其 
它 平 台 上 ,你 可 以 创建 一 个 wxContextHelpButton 类 型 的 按钮 ,这 个 按钮 通常 应 该 位 于 OK 和 
Cancel 按 钮 的 旁边 .然后 ,在 对 话 框 初始 话 的 时 候 ,增加 下 面 的 代码 : 


#include "wx/cshelp.h" 
wxHelpProvider: :Set(new wxSimpleHelpProvider ); 


这 将 告诉 wxwWidgets 怎 样 提供 上 下 文敏 感 帮助 , 然后 调用 SetHeLpText 来 设置 某 个 控件 的 上 下 文敏 感 帮助 文本 .下面 是 我 


void PersonalRecordDialog: :SetDialogHelp() 
{ 

wxString nameHelp = wxT("Enter your full name."); 

wxString ageHelp = wxT("Specify your age."); 

wxString sexHelp = wxT("Specify your gender, male or female."); 

wxString voteHelp = wxT("Check this if you wish to vote."); 

FindwWindow( ID_NAME) ->SetHelpText (nameHelp) ; 

FindWindow( ID_NAME) ->SetToolTip(nameHelp) ; 

FindWindow(ID_AGE) ->SetHelpText(ageHelp) ; 

FindwWindow(ID_AGE) ->SetToolTip(ageHelp) ; 
FindwWindow( ID_SEX) ->SetHelpText(sexHelp) ; 
FindwWindow(ID_SEX) ->SetToolTip(sexHelp) ; 
FindWindow(ID_VOTE) ->SetHelpText(voteHelp) ; 
FindWindow(ID_VOTE) ->SetToolTip(voteHelp) ; 


ee: 


如 果 你 希望 自己 控制 上 下 文敏 感 帮助 ,而 不 想 通过 对 话 框 的 上 下 文敏 感 帮助 按钮 或 者 
wxContextHelpButton 按 钮 ,你 可 以 在 任何 事件 处 理 落 数 中 使 用 下 面 的 代码 : 





wxContextHelp contextHelp(window) ; 
这 将 使 wxWidgets 进 入 一 个 检测 左 键 单 击 的 死 循 环 , 当 单 击 事件 发 生 时 ,wxWidgets 给 对 应 的 控 
件 发 送 wxEVT_HELP 事 件 ,你 可 以 拦截 这 个 事件 以 便 弹 出 你 自己 的 帮助 窗口 . 


你 不 必 闻 自己 限制 于 wxWidgets 实 现 的 存储 显 式 帮助 文本 的 方式 ,你 可 以 创建 自己 的 
wxHelpProvider 派 生 类 ,进而 实现 自己 的 GetHelp, SetHelp, AddHelp, RemoveHelp 和 
ShowHelp žė. 

联机 帮助 


大 多 数 应 用 程序 都 会 在 一 个 帮助 文件 中 提供 使 用 应 用 程序 的 详细 说 明 .wxWidgets 也 对 应 于 这 
种 应 用 提供 了 几 个 对 应 的 控件 ,这 些 控件 都 是 wxHelpControllerBase 的 派生 类 .参考 第 20 章 ," 优 
化 你 的 应 用 程序 "来 获得 这 方面 更 详细 的 信息 . 


针对 我 们 这 个 应 用 程序 而 言 ,我 们 只 是 简单 的 在 用 户 点 击 帮助 按钮 的 时 候 显 式 一 个 消息 框 . 


BEGIN_EVENT_TABLE( PersonalRecordDialog, wxDialog ) 
EVT_BUTTON( wxID_HELP, PersonalRecordDialog: :OnHelpClick ) 


END_EVENT_TABLE( ) 
void PersonalRecordDialog: :OnHelpClick( wxCommandEvent& event ) 
{ 
// 通常 我 们 需要 用 下 面 注释 的 代码 提供 联机 帮助 
Ue 
wxGetApp().GetHelpController().DisplaySection(wxT("Personal record dialog")); 
S 


// 在 这 个 例子 中 ,我 们 只 简单 的 提供 一 个 消息 杠 
wxString helpText = 
wxT( "Please enter your full name, age and gender.\n") 
wxT("Also indicate your willingness to vote in general elections. \n\n") 
wxT("No non-alphabetical characters are allowed in the name field. \n") 
wxT("Try to be honest about your age."); 
wxMessageBox(helpText, 
wxT("Personal Record Dialog Help"), 
wxOK|wxICON_INFORMATION, this); 


完整 的 例子 
这 个 例子 完整 的 代码 列举 在 附录 J," 代 码 列表 "中 ,你 也 可 以 在 附送 光盘 的 examples/chap09 找 到 . 
调用 这 个 对 话 框 


现在 我 们 需要 调用 这 个 对 话 框 来 完成 所 有 的 编码 ,我 们 可 以 使 用 下 面 的 代码 来 调用 这 个 对 话 框 : 


PersonalRecordDialog dialog(NULL, ID_PERSONAL_RECORD, 
wxT("Personal Record")); 
dialog.SetName(wxEmptyString); 
dialog.SetAge(30); 
dialog.SetSex(0); 
dialog.SetVote(true); 
if (dialog.ShowModal() == wxID_OK) 
{ 
wxString name = dialog.GetName(); 
int age = dialog.GetAge(); 
bool sex = dialog.GetSex(); 
bool vote = dialog.GetVote(); 


9.3 在 小 型 设备 上 调整 你 的 对 话 框 


wxWidgets 的 几 个 不 同 的 版 本 都 可 以 用 于 支持 移动 设备 和 散人 式 平台 ,比如 GTK+ 版 本 ,X11 的 版 
本 以 及 WindowsCE 的 版 本 (将 来 也 许 还 会 有 别 的 版 本 ).. 在 这 些小 型 设备 使 用 的 最 大 的 问题 在 于 
屏幕 的 大 小 ,一 个 smartphone 的 屏幕 的 大 小 甚至 只 有 176x220 个 象 素 . 


对 于 这 样 的 小 型 屏幕 来 说 ， ee 甚至 有 些 控件 本 身 都 需 
要 被 移 除 ,尤其 是 那些 相 比 较 于 桌面 系统 中 其 功能 已 经 被 移 除 的 那 部 分 控件 .你 可 以 使 用 
wxSystemSettings::GetScreenType rH 2X 3 EX 4 ES 如 下 所 示 : 


#include "wx/settings.h" 
bool isPda = (wxSystemSettings: :GetScreenType() &lt;= wxSYS_SCREEN_PDA); 


这 个 函数 的 返回 值 列 举 在 下 表 中 ,因为 它 随 着 屏幕 实际 尺寸 的 增长 而 增加 ,因此 你 可 以 直接 对 其 
通过 简单 的 整数 比较 的 方法 ,来 判断 是 否 为 比 某 个 屏幕 更 大 或 者 更 小 的 屏幕 . 


wxSYS_SCREEN_NONE 未 定义 屏幕 类 型 

wxSYS_SCREEN_TINY 微小 屏幕 ,尺寸 小 于 320x240 
wxSYS_SCREEN_PDA PDA 屏 幕 , 尺寸 在 320x240 到 640x480 之 间 
wxSYS_SCREEN_SMALL 小 型 屏幕 ,尺寸 在 640x480 到 800x600 之 间 
wxSYS_SCREEN_DESKTOP 桌面 屏幕 ,尺寸 大 于 800x600 


如 果 你 需要 更 具体 的 大 小 ,你 可 以 使 用 下 面 的 方法 : 


1. 使 用 wxSystemSettings::GetMetric, 传递 WxSYS_SCREEN_X 或 wxSYS_SCREEN _Y 参 
数 . 

2. 使 用 wxGeTDisplaySize, 得 到 一 个 wxSize 类 型 的 屏幕 大 小 . 

3. 创建 一 个 wxDisplay 对 象 ,调用 其 GetGeometry 成 员 画 数 , 将 返回 表征 当前 屏幕 的 一 个 矩形 
区 域 (wxRect 类 型 ). 


当 你 明确 知道 你 的 程序 将 在 一 个 很 小 的 屏幕 上 运行 的 时 候 , 你 可 以 作 些 什么 呢 ? 这 里 我 们 给 出 一 
些 建 议 : 


1. 使 用 从 一 个 不 同 的 XRC 文 件 加 载 布局 的 方法 来 代 蔡 整个 布局 代码 或 者 针对 小 型 的 屏幕 使 
用 不 同 的 布局 代码 ,只 要 你 不 更 改 控件 的 类 型 ,事件 处 理 琅 数 的 代码 就 不 需要 作 任 何 改动 . 

2. 减 小 控件 以 及 空白 区 域 的 大 小 . 

3， 改 变 控 件 的 类 型 (比如 使 用 wxComboBox 来 代替 wxListBox), 这 闻 导 致 一 些 相 关 处 理 函 数 的 
代码 的 改动 

4. 改变 布局 的 方向 .一 些小 型 设备 通常 在 和 桌面 屏幕 相反 的 方向 拥有 更 多 的 空间 . 


有 时 候 你 还 需要 使 用 针对 特定 平台 的 API 画 数 .比如 微软 的 Smartphone 有 两 个 特殊 的 按钮 ,你 可 
以 对 其 设置 标签 ,比如 "OK", "Cancel" 之 类 的 .在 这 种 平台 上 ,你 可 以 使 用 调用 
wxDialog::SetLeftMenu 和 wxDialog::SetRightMenu 画 数 (参数 为 标识 符 , 标 签 以 及 可 选 的 子 菜 
单 ) 来 取代 产生 两 个 单独 的 按钮 .当然 由 于 这 些 函 数 仅 存在 于 这 个 平台 ,因此 你 需要 使 用 宏 开 关 来 
区 分 不 同 的 平台 : 


#ifdef _ SMARTPHONE__ 
SetLeftMenu(wxID_OK, wxT("OK")); 
SetRightMenu(wxID_OK, wxT("Cancel")); 
#else 
wxBoxSizer* buttonSizer = new wxBoxSizer (wxHORIZONTAL ) ; 
GetTopSizer()->Add(buttonSizer, ©, wxALL|wxGROW, 0); 
buttonSizer->Add(new wxButton(this, wxID_OK), ©, wxALL, 5); 
buttonSizer->Add(new wxButton(this, wxID_CANCEL), ©, wxALL, 5); 
#endif 


9.4 一 些 更 深入 的 话题 


下 面 的 这 些 提示 可 以 让 你 创建 的 对 话 框 看 上 去 更 专业 . 
键盘 导航 


尽量 给 你 的 对 话 框 上 的 控件 的 标签 增加 "&" 前 导 符 ,在 某 些 平台 (特别 明显 的 是 在 windows 和 
GTK+ 平 台 上 ), 这 将 使 得 用 户 可 以 通过 键盘 在 控件 之 间 移 动 . 


总 是 给 你 的 对 话 框 提供 一 个 取消 操作 ,最 好 是 使 用 Escape 键 来 执行 这 个 操作 .如 果 你 的 对 话 框 有 
一 个 标识 符 为 wxID_CANCEL 的 按钮 ,那么 默认 情况 下 它 的 义理 函数 将 在 用 户 按 下 Escape 键 的 
时 候 被 执行 ,因此 ,如 果 你 有 一 个 单纯 用 来 关闭 对 话 框 的 按钮 ,最 好 将 它 的 标识 符 定义 为 
wxID_CANCEL. 


提供 一 个 默认 按钮 (通常 为 OK 按钮 ), 你 可 以 通过 wxButton::SetDefault 函 数 指定 一 个 默认 按钮 ， 
这 个 按钮 的 义理 函数 笃 在 用 户 按 下 回 车 键 的 时 候 被 调用 . 


数据 和 用 户 界 面 分 离 


为 了 简化 例子 ,我 们 在 PersonalRecordDialog 中 采用 了 把 数据 存放 在 对 话 框 内 部 的 方法 .然而 ,一 
个 更 好 的 设计 应 该 是 让 用 户 数 据 和 对 话 框 分 离 ,在 构造 画 数 中 进行 赋值 操作 ,这 样 的话 你 就 可 以 
更 方便 的 传递 一 组 数据 给 这 个 对 话 框 的 构造 画 数 ,以 及 在 用 户 确认 修改 的 时 候 ( 按 下 OK 按钮 的 
时 候 ) 从 对 话 框 获取 一 整 组 数据 .这 也 是 大 多 数 标准 对 话 框 采用 的 方法 .作为 一 个 练习 ,你 可 以 使 
用 PersonalRecordData 类 作为 PersonalRecordDialogh ade AX A = SPersonalRecordDialog 
BY 3, LES xt iS HEN IG AKA PersonalRecordData 的 引用 作为 参数 ,而 对 话 框 的 
Getdata 辑 数 则 返回 其 内 部 数据 的 引用 . 


一 般 说 来 ,你 应 该 尽 可 能 的 将 界面 功能 和 非 界 面 功 能 分 开 . 这 通常 会 让 你 的 代码 显得 更 紧 姿 .不 要 
害怕 增加 新 的 类 , 它 会 让 你 的 设计 更 优雅 ,也 不 要 惧怕 在 类 中 使 用 复制 或 者 赋值 之 类 的 操作 ,如 果 
一 个 对 象 能 够 很 容易 的 被 赋值 和 赋值 ,应 用 程序 可 以 少 些 很 多 底层 的 赋值 代码 . 


除非 你 的 对 话 框 提供 了 一 个 类 似 "Apply" 功 能 的 按钮 ,否则 ,在 对 话 框 被 取消 之 后 ,所 有 内 部 的 数 
据 应 该 保持 原样 .使 用 数据 和 界面 分 离 的 原则 也 使 得 实现 这 一 点 变 得 相对 容易 ,因为 通常 在 这 种 
情况 下 ,你 只 是 操作 数据 的 一 份 拷 贝 而 不 是 数据 本 身 . 


布局 


如 果 你 的 对 话 框 看 上 去 好 像 显 得 有 些 拥挤 或 者 说 有 些 姑 陋 , 可 能 是 因为 你 没有 给 予 足 够 的 空白 
区 间 . 你 可 以 尝试 单独 使 用 一 个 布局 控件 来 增加 一 个 大 的 边界 区 域 ,就 象 我 们 在 例子 中 作 的 那样 ， 
在 一 组 控件 和 另外 一 组 控件 之 间 增 加 空白 ,或 者 使 用 wxStaticBoxSizer 和 wxStaticLine 将 逻辑 上 
处 于 两 组 的 控件 区 隔 开 .使 用 wxGridSizer 和 wxFlexGridSizer 布 局 控件 来 对 齐 控件 及 它们 对 应 
的 标签 以 便 它们 的 位 置 显得 不 那么 需 乱 .在 基于 布局 控件 的 布局 中 ,还 可 以 使 用 空白 区 域 来 实现 


对 齐 . 比 如 ,通常 OK,Cancel 按 钮 和 Help 按 钮 应 该 被 设置 为 右 对 齐 ,你 可 以 通过 在 水 平 
WwWXBoxSizer 的 水 平方 向 上 增加 一 个 可 以 缩放 的 (缩放 因子 不 为 负数 的 ) 空 白 区 域 ,然后 再 增加 这 
些 按钮 ,以 便 在 对 话 框 的 水 平 大 小 发 生 改变 时 实现 按钮 的 右 对 齐 . 


尽 可 能 的 让 你 的 对 话 框 的 边框 是 可 以 改变 大 小 的 ,通常 windows 系 统 上 的 对 话 框 的 大 小 是 不 能 
被 改变 的 ,但 是 这 样 做 实在 是 有 些 无 厘 头 . 在 一 个 大 的 对 话 框 上 使 用 很 少 的 控件 通常 都 邻 用 户 感 
到 泪 表 .在 wxWidgets 下 通过 布局 控件 创建 可 变 大 小 的 对 话 框 是 非常 简单 的 事情 ,你 应 该 尽 可 能 
的 使 用 布局 控件 以 便 你 的 对 话 框 可 以 自 适 应 字体 和 语言 以 及 对 话 框 大 小 的 改变 .当然 ,你 要 小 心 
的 选择 那些 可 以 随 着 对 话 框 大 小 的 改变 而 改变 大 小 的 控件 ,例如 ,多 行文 本 框 控件 就 是 一 个 不 错 
的 选择 , 它 的 大 小 随 着 对 话 框 的 大 小 一 起 增长 可 以 给 用 户 更 多 实用 的 空间 ,另外 ,你 还 可 以 考虑 把 
增加 的 空间 分 给 空白 区 域 以 实现 对 章 .注意 我 们 这 里 说 的 控件 增 大 ,不 是 只 的 缩放 控件 或 者 是 让 
控件 的 文本 变 的 更 大 ,而 仅仅 是 指 的 增加 控件 的 宽度 和 高 度 .参考 第 7 章 以 得 到 更 多 关于 布局 控 
件 的 知识 . 


如 果 你 发 现 你 的 对 话 框 上 放置 了 太 多 的 控件 ,你 应 该 考虑 增加 面板 ,并 且 使 用 wxNotebook.， 
wxListbook 或 wxChoicebook 来 进行 分 页 .使 用 太 多 菜单 来 打开 很 多 互 不 相干 的 对 话 框 通常 是 非 
常 合用 户 感到 不 爽 的 ,用 分 页 控件 ,用 户 自己 选择 查看 哪个 页 面 ,这 样 就 显得 方便 多 了 .同时 在 面 
板 里 使 用 滚动 条 也 是 应 该 被 避免 的 (除非 你 又 充足 的 原因 ). 这 一 方面 是 因为 不 是 所 有 的 平台 都 
支持 滚动 控件 , 另外 一 方面 ,这 也 会 给 用 户 一 个 印象 :你 对 控件 布局 并 没有 进行 充分 的 设计 .如 果 
你 有 很 多 的 属性 需要 用 户 编辑 ,你 可 以 考虑 使 用 基于 wxGrid 的 属性 编辑 器 或 者 其 它 的 第 三 方 控 
件 (参考 wxPropertyGrid, 在 附录 E,"wxWidgets 的 第 三 方 工具 "中 有 提 到 这 个 控件 )， 


美学 


标签 的 大 小 写 要 保持 一 致 .不 要 给 对 话 框 设置 自 定义 的 颜色 和 字体 ,这 有 时 候 会 让 你 的 用 户 感到 
抓 狂 而 且 也 使 得 你 的 应 用 程序 看 上 去 有 些 特 立 独 行 (贬义 ), 和 系统 当前 的 风格 或 者 你 的 应用 程 
序 中 的 其 它 对 话 框 不 一 致 .要 在 各 个 平台 都 取得 不 错 的 效果 ,最 好 让 wxWidgets 自 己 决 定 对 话 框 
的 颜色 或 者 字体 .取而代之 的 ,你 可 以 把 精力 花费 在 设计 一 些 新 颖 而 紧凑 的 小 图 片上 ,并 且 在 合适 
的 位 置 使 用 wxStaticBitmap 控 件 显 式 它 . 


对 话 框 的 替代 品 


最 后 ,对 于 那些 非 模式 的 解决 方案 ,你 应 该 好 好 考虑 是 否 要 使 用 一 个 对 话 框 ,也 许 在 应 用 程序 的 主 
窗口 中 使 用 TAB 控件 会 是 更 好 的 选择 . 尽管 我 们 前 面 所 说 的 大 部 分 原则 都 适用 于 非 模式 的 对 框 
框 ,但 是 它们 确实 有 一 些 不 同 之 处 ,比如 你 需要 额外 考虑 布局 (通常 这 种 窗口 拥有 原 少 于 它 的 大 小 
的 控件 ) 以 及 数据 同步 (对 于 非 模式 窗口 来 说 , 它 在 显示 的 时 候 不 能 以 独占 的 方式 访问 它 的 数据 
T). 


9.5 使 用 wxWidgets 资 源 文件 


你 可 以 从 一 个 Xml 文件 中 加 载 对 话 框 ,frame 窗 口 ,菜单 条 ,工具 条 等 等 ,而 不 一 定 非 要 用 C++ 代码 
来 创建 它们 .这 更 符合 界面 和 代码 分 离 的 原则 , 它 可 以 让 应 用 程序 的 界面 在 运行 期 改变 .XRC 文 
件 可 以 通过 一 系列 用 户 界面 设计 的 工具 导出 ,比如 :wxDesigner, DialogBlocks, XRCed 和 
wxGlade. 


加 载 资源 文件 
要 使 用 XRC 文 件 ,你 需要 在 你 的 代码 中 包含 wx/xrc/xmlres.h 头 文件 . 


如 果 你 打算 将 你 的 XRC 文 件 转换 成 二 进 制 的 XRS 文 件 ( 我 们 很 快 会 介绍 suis 还 需要 增加 zip 文 
件 系 统 的 处 理 函 数 ,你 可 以 在 你 的 OnInit 函 数 中 增加 下 面 的 代码 来 作 到 这 一 点 : 


#include "wx/filesys.h" 
#include "wx/fs_zip.h" 
wxFileSystem: :AddHandler (new wxZipFSHandler ); 


首先 初始 化 XRC 处 理 系统 ,你 需要 在 Onlnit 中 增加 下 面 的 代码 : 


wxXmlResource: :Get()->InitAllHandlers(); 


然后 加 载 一 个 XRC 文 件 : 


wxXmlResource: :Get()->Load(wxT("resources.xrc")); 


这 只 是 告诉 wxWidgets 这 个 资源 文件 的 存在 ,要 创建 真实 的 用 户 界 面 ,还 需要 类 似 下 面 的 代码 : 


MyDialog dlg; 
wxXmlResource: :Get()->LoadDialog(& dlg, parent, wxT("dialogi")); 
dlg.ShowModal(); 


下 面 的 代码 则 演示 了 怎样 创建 菜单 条 ,菜单 ,工具 条 ,位 图 ,图 标 以 及 面板 : 


MyFrame: :MyFrame(const wxString& title): wxFrame(NULL, -1, title) 


SetMenuBar (wxXmlResource: :Get()->LoadMenuBar (wxT("mainmenu") )); 
SetToolBar (wxXmlResource: :Get()->LoadToolBar (this, 
wxT("toolbar"))); 

wxMenu* menu = wxXmlResource: :Get()->LoadMenu(wxT("popupmenu") ) ; 

wxIcon icon = wxXmlResource: :Get()->LoadIcon(wxT("appicon")); 

SetIcon(icon); 

wxBitmap bitmap = wxXmlResource: :Get()->LoadBitmap(wxT("bmp1i") ); 

// 既 可 以 先 创建 实例 再 加 载 

MyPanel* panelA = new MyPanel; 

panelA = wxXmlResource: :Get()->LoadPanel(panelA, this, 
wxT("panelA")); 

// 又 可 以 直接 创建 并 加 载 

wxPanel* panelB = wxXmlResource: :Get()->LoadPanel(this, 
wxT("panel1B")); 


wxWidgets 维 护 一 个 全 局 的 wxXmlResource 对 象 ,你 可 以 直接 拿 来 使 用 ,也 可 以 创建 一 个 你 自己 
的 wxXmlResource 对 象 ,然后 加 载 某 个 资源 文件 ,然后 使 用 和 释放 它 .你 还 可 以 使 用 
wxXmlResource:: Set aK ik t FAFSA BES wxXmlResource 对 象 来 取代 全 局 资源 对 象 ,并 
释放 掉 那 个 旧 的 . 


要 为 定义 在 资源 文件 中 的 控件 定义 事件 表 条 目 , 你 不 能 直接 使 用 整数 的 标识 符 ,因为 资源 文件 中 
存放 的 其 实 是 字符 串 , 你 需要 使 用 XRCID 宏 , 它 的 参数 是 一 个 资源 名 ,返回 值 是 这 个 资源 对 应 的 
标识 符 .其 实 XRCID 就 是 直 Ee | GAR OI Ra THIF: 


BEGIN_EVENT_TABLE(MyFrame, wxFrame) 
EVT_MENU(XRCID("menu_quit"), MyFrame: :OnQuit) 
EVT_MENU(XRCID("menu_about"), MyFrame: :OnAbout ) 

END_EVENT_TABLE( ) 
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你 可 以 把 多 个 wxWidgets 资 源 文 件 编译 成 一 个 二 进 制 的 压缩 的 xrs 文 件 .使 用 的 工具 wxrc 可 以 在 
wxWidgets 的 utils/wxrc 目 录 中 找到 ,使 用 方法 如 下 : 


Wxrc resourcel1.xrc resource2.xrc -0 resource.xrs 


4 FA wxXmlResource::LoadE ata & — 进 制 的 压缩 的 资源 文件 ,和 加 载 普 通 的 文本 Xml 文 
件 没有 区 别 . 


提示 : 你 可 以 不 必 把 你 的 XRC 文 件 单独 制作 一 个 zip 压 缩 文 件 ,而 是 把 它 放 在 其 它 一 个 可 能 包含 
HTML 文 件 以 及 图 片 文件 的 普通 的 zip 压 缩 文 件 中 , wxXmlResource::Loadis Bh 3 #3 i AEH 
统 定义 (参考 第 14 章 :" 文 件 和 流 "), 因 此 你 可 以 通过 下 面 的 方法 来 加 载 压缩 文件 中 的 XRC 文 件 : 


wxXmlResource: :Get()->Load(wxT("resources.bin#zip:dialogs.xrc")); 


你 也 可 以 将 XRC 文 件 编译 为 C++ 的 代码 ,通过 和 别 的 C++ 的 代码 编译 在 一 起 ,你 就 可 以 去 掉 某 个 
单独 的 资源 文件 了 .编译 用 的 命令 行 如 下 所 示 : 


wxrc resource1.xrc resource2.xrc c -0 resource.cpp 


编译 方法 和 编译 普通 的 C++ 代 码 相同 ,这 个 文件 包含 一 个 InitXmlResource 函 数 ,你 必须 在 你 的 主 
程序 中 调用 这 个 范 数 : 


extern void InitXmlResource(); // defined in generated file 
wxxXmLResource: :Get()->InitAllHandlers(); 
InitXmlResource(); 


下 面 列 出 了 wxrc 程 序 的 命令 行 参数 : 


短命 合格 式 


-O 
<filename> 


-| 
<filename> 


资源 翻译 


help 
verbose 
cpp-code 
python-code 


extra-cpp- 
code 


uncompressed 


gettext 


function 
<name> 


output 
<filename> 


list-of-handlers 
<filename> 


描述 
显 式 帮助 信息 . 
打印 执行 过 程 信息 . 


编译 目标 为 C++ 代码 ,而 不 是 XRS 文 件 . 
编译 目标 为 Python 代码 而 不 是 XRS 文 件 . 


和 -c 一 起 使 用 ,指示 为 XRC 定 义 的 窗口 生成 头 文件 . 


不 要 压缩 Xml 文件 (C++ only). 


将 相关 的 字符 串 翻译 为 poEdit 或 者 gettext 可 以 识别 的 格 
式 . 输 出 到 标准 输出 或 者 某 个 文件 中 (如 果 指 定 了 -o 参 数 
的 话 ). 


指定 特定 的 C++ 初 始 化 函数 (和 -c 一 起 使 用 ). 


指定 输出 文件 名 ,比如 resource.xrs or resource.cpp. 


列举 这 个 资源 文件 所 需要 的 久 理 函数 . 


如 果 wxXmlResource 对 象 创 建 的 时 候 指 定 了 wxXRC_USE_LOCALE 标 记 ( 默 认 行 为 ) 所 有 可 显 
示 的 字符 串 都 将 被 认为 是 需要 翻译 的 ,具体 内 容 参 考 第 16 章 ," 编 写 国 际 化 应 用 程序 ", 然 后 poEdit 
并 能 查找 XRC 文 件 来 发 现 那些 需要 翻译 的 字符 串 , 因 此 ,必须 使 用 "-g" 参数 产生 一 个 对 应 的 
C++ 文件 ,以 供 poEdit 使 用 ,命令 行 如 下 : 


wxrc -g resources.xrc -o resource_strings.cpp 


然后 你 就 可 以 使 用 poEdit 来 搜索 这 个 和 其 它 的 C++ 文件 了 . 


XRC 的 文件 格式 


这 里 显然 不 是 完整 描述 XRC 文 件 格式 的 地 方 ,因此 我 们 只 举 一 个 简单 的 使 用 了 布局 控件 的 例子 


<?xml version="1.0"?> 
<resource version="2.3.0.1"> 
<object class="wxDialog" name="simpledlg"> 
<title>A simple dialog</title> 
<object class="wxBoxSizer"> 
<orient>wxVERTICAL</orient> 
<object class="sizeritem"> 
<object class="wxTextCtr1"> 
<size>200, 200d</size> 
<style>wxTE_MULTILINE |wxSUNKEN_BORDER</style> 


<value>Hello, this is an ordinary multiline\n textctrl....</value> 
</object> 
<option>1</option> 


<flag>wxEXPAND | wxALL</flag> 
<border>10</border> 
</object> 
<object class="sizeritem"> 
<object class="wxBoxSizer"> 
<object class="sizeritem"> 
<object class="wxButton" name="wxID_OK"> 
<label>0k</label> 
<default>1</default> 
</object> 
</object> 
<object class="sizeritem"> 
<object class="wxButton" name="wxID_CANCEL"> 
<label>Cancel</label> 
</object> 
<border>10</border> 
<flag>wxLEFT</flag> 
</object> 
</object> 
<flag>wxLEFT |wxRIGHT | wxBOTTOM |wxALIGN_RIGHT</flag> 
<border>10</border> 
</object> 
</object> 
</object> 
</resource> 


XRC 文 件 格 式 的 详细 描述 可 以 在 wxWidgets 自 带 的 文档 目录 docs/tech/tn0014.txt 中 找到 .如 果 
你 使 用 对 话 框 编辑 器 的 话 ,你 管 它 的 文件 格式 干 嘛 呢 . 


你 可 能 回 问 怎样 在 XRC 文 件 中 指定 二 进 制 的 图 片 或 者 图 标 文件 呢 ? 实 peace lates: 
URLs 来 指定 的 ,wxWidgets 的 虚拟 文件 系统 将 会 从 合适 的 地 方 (比如 一 个 
的 文件 .举例 如 下 : 





BE 
xt 
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<object class="wxBitmapButton" name="wxID_OK"> 
<bitmap>resources.bin#zip:okimage.png</bitmap> 
</object> 


关于 使 用 虚拟 文件 系统 加 载 资源 或 者 图 片 的 细节 ,请 参考 第 10 章 ," 在 程序 中 使 用 图 片 " 以 及 第 14 
章 " 文 件 和 流 ". 
编写 资源 义理 类 


XRC 系 统 使 用 不 同 的 资源 处 理 类 来 识别 Xml 文件 中 定义 的 不 同 的 资源 .如 果 你 编写 了 自己 的 控 
件 ,你 就 需要 编写 自己 的 资源 处 理 类 . 


wxButton 的 资源 处 理 类 如 下 所 示 : 


#include "wx/xrc/xmlres.h" 
class wxButtonXmlHandler : public wxXmlResourceHandler 


DECLARE_DYNAMIC_CLASS(wxButtonXmlHandler ) 
public: 
wxButtonXmlHandler(); 
virtual wxObject *DoCreateResource(); 
virtual bool CanHandle(wxxXmlNode *node); 


}; 


资源 处 理 类 的 实现 是 非常 简单 的 .在 其 构造 画 数 的 实现 中 ,使 用 XRC_ADD_STYL 宏 来 使 得 处 理 
类 可 以 识别 控件 相关 的 特殊 的 窗口 类 型 ,然后 使 用 AddWindowStyles 增 加 这 些 类 型 .然后 在 
DoCreateResource 画 数 中 ,使 用 两 步 法 创建 按钮 实例 ,其 中 第 一 步 要 使 用 
XRC_MAKE_INSTANCE 画 数 ,然后 调用 Create 画 数 ,参数 需要 使 用 对 应 的 范 数 从 Xml 文件 中 获 

得 .而 CanHandle 画 数 则 用 来 回答 是 否 这 个 处 理 类 可 以 处 理 某 个 Xml 节点 的 问题 .使 用 一 个 处 理 
类 义理 多 种 Xml 节点 是 允许 的 . 


IMPLEMENT_DYNAMIC_CLASS(wxButtonXmlHandler, wxXmlResourceHandler ) 
wxBut tonXmlHandler : :wxButtonXmlHand1ler ( ) 
: wxXmlResourceHandler () 
{ 
XRC_ADD_STYLE(wxBU_LEFT) ; 
XRC_ADD_STYLE(wxBU_RIGHT) ; 
XRC_ADD_STYLE(wxBU_TOP) ; 
XRC_ADD_STYLE(wxBU_BOTTOM) ; 
XRC_ADD_STYLE(wxBU_EXACTFIT) ; 
AddWindowStyles(); 


wxObject *wxButtonXmlHandler: :DoCreateResource() 


XRC_MAKE_INSTANCE(button, wxButton) 
button->Create(m_parentAsWindow, 
GetID(), 
GetText(wxT("label")), 
GetPosition(), GetSize(), 
GetStyle(), 
wxDefaultValidator, 
GetName()); 
if (GetBool(wxT("default"), 0)) 
button->SetDefault(); 
SetupWindow(button) ; 
return button; 


} 
bool wxButtonXmlHandler: :CanHandle(wxXmlNode *node) 
{ 
return IsOfClass(node, wxT("wxButton")); 
} 


要 使 用 某 种 处 理 类 ,应 用 程序 需要 包含 相应 的 头 文件 并 且 登 记 这 个 处 理 类 ,就 象 下 面 这 样 : 


#include "wx/xrc/xh_bttn.h" 
wxXmlResource: :AddHandler (new wxBitmapXmlHandler ) ; 


外 来 控件 


XRC 文 件 还 可 以 通过 class="unknown" 来 指定 某 个 控件 是 外 来 的 或 者 说 是 "未 知 的 "控件 .这 可 以 
用 来 实现 在 其 父 窗口 已 经 加 载 到 应 用 程序 之 中 以 后 ,使 用 C++ 代码 来 创建 这 个 未 知 的 控件 . 当 
XRC 文 件 加 载 一 个 未 知 控件 的 时 候 , 它 将 创建 一 个 用 来 占 位 的 窗口 ,然后 在 代码 中 ,可 以 使 用 C 
++ 先 创建 这 个 实际 的 控件 ,然后 使 用 AttachUnknownControl 画 数 替 换 掉 那个 用 来 占 位 的 窗口 . 
如 下 所 示 : 


wxDialog dlg; 

// 加 载 对 话 框 

wxXmlResource: :Get()->LoadDialog(&dlg, this, wxT("mydialog")); 

// 创建 特殊 控件 

MyCtrl* myCtrl = new MyCtrl(&dlg, wxID_ANY); 

// 增加 到 对 话 框 里 

wxXmlResource: :Get()->AttachUnknownControl(wxT("custctrl"), myCtr1); 
// 显示 整个 对 话 框 

dlg.ShowModal( ); 


外 来 的 控件 在 XRC 文 件 中 可 以 这 样 定义 : 


<object class="unknown" name="Ccustctr1"> 
<size>100, 100</size> 
</object> 


使 用 这 种 技术 ,你 可 以 既 不 用 创建 新 的 资源 处 理 类 ,又 可 以 在 资源 文件 中 使 用 未 知 的 控件 . 


第 九 章 小 结 


在 这 一 章 里 ,你 学 习 了 怎样 创建 自 定 义 对 话 框 的 一 些 基本 原理 ,包括 布局 控件 概览 ,使 用 验证 器 以 
及 义理 Ul 更 新 时 间 的 优点 等 .在 wxWidgets 自 带 的 samples/dialogs 目 录 中 你 也 可 以 看 到 一 个 自 
定义 对 话 框 的 例子 .另外 samples/validate 目 录 中 的 例子 则 演示 了 一 般 的 文本 验证 器 的 用 法 .在 
下 一 章 里 ,我 们 来 看 看 怎样 处 理 图 片 . 


第 十 章 使 用 图 像 编程 


这 一 章 来 了 解 一 下 我 们 可 以 使 用 图 片 来 作 些 什么 事情 .一 幅 图 胜 过 千言 万 语 ,在 wxWidgets, 工 具 
条 , 树 形 控件 ,notebooks, 按 钮 ,Html 窗 口 和 特定 的 绘画 代码 中 ,都 会 用 到 图 片 .有 时 候 它 们 还 会 在 
不 可 见 的 地 方 发 挥 作用 ,比如 我 们 可 以 用 它 来 创建 双 缓 冲 区 以 避免 闪烁 .这 一 章 里 ,我 们 会 接触 到 
各 种 各 样 的 图 片 类 ,还 会 谈 到 怎样 覆盖 wxWidgets 提 供 的 默认 图 片 和 图 标 . 


10.1 wxWidgets 中 图 片 相关 的 类 


wxWidgets 支 持 四 种 和 位 图 相关 的 类 :wxBitmap, wxlcon, wxCursor 和 wxlmage. 


wxBitmap 是 一 个 平台 有 关 的 类 , 它 拥 有 一 个 可 选 的 wxMask 属 性 以 支持 透明 绘画 .在 windows 系 
统 上 ,wxBitmap 是 通过 设备 无 关 位 图 (DIBs) 实 现 的 ,而 在 GTK+ 和 X11 平台 上 ,每 个 wxBitmap 则 
包含 一 个 GDK 的 pixmap 对 象 或 者 X11 的 pixmap 对 象 .而 在 Mac 平 台 上 , 则 使 用 的 是 
PICTwxBitmap 可 以 和 wxlmage 进 行 互相 转换 . 


wxlcon 用 来 实现 各 个 平台 上 的 图 标 ,一 个 图 标 指 的 是 一 个 小 的 透明 图 片 ,可 以 用 来 代表 不 同 的 
frame 或 者 对 话 框 窗口 .在 GTK+, X11 和 Mac 平 台 上 ,icon 就 是 一 个 小 的 总 含有 wxMask 的 
WwWXxBitmp, 而 在 windows 平 台 上 ,wxlcon 则 是 封装 了 HICON 对 象 . 


wxCursor 则 是 一 个 用 来 展示 鼠标 指针 的 图 像 ,在 GTK+ 平 台 上 是 用 的 GdkCursorX11 和 Mac 平 台 
上 用 的 是 各 自 的 Cursor, 而 在 windows 平 台 上 则 使 用 的 是 HCURSOR.wxCursor 有 一 个 热点 的 概 
念 (所 谓 热点 指 的 是 图 片 中 用 来 精确 代表 指针 单 击 位 置 的 那个 点 ), 也 总 是 包含 一 个 庶 章 (mask). 


wxlmage 则 是 四 个 类 中 唯一 的 一 个 平台 无 关 的 实现 , 它 支持 24bit 位 图 以 及 可 选 的 alpha 通 

道 .wxlImage 可 以 从 wxBitmap 类 使 用 wxBitmap::ConvertTolmage 函 数 转换 而 来 ,也 可 以 从 各 种 
各 样 的 图 片 文 件 中 加 载 , 它 所 支持 的 图 片 格式 也 是 可 以 通过 图 片 格式 处 理 器 来 扩展 的 . 它 拥有 操 
作 其 图 片上 某 些 bit 的 能 力 ,因此 也 可 以 用 来 对 图 片 进行 一 个 基本 的 操作 .和 wxBitmap 不 

同 ,wxlmage 不 可 以 直接 被 设备 上 下 文 wxDC 使 用 ,如 果 要 在 wxDC 上 绘图 ,需要 现 将 wxImage 转 

换 成 wxBitmap, 然 后 就 可 以 使 用 wxDC 的 DrawBitmap 画 数 进 行 绘 图 了 .wxlmage 支 持 设置 一 个 

掩 码 颜色 来 实现 透明 的 效果 ,也 支持 通过 alpha 通 道 实 现 非常 复杂 的 透明 效果 . 


你 可 以 在 这 些 图 片 类 型 之 间 进 行 相互 转换 ,尽管 某 些 转换 操作 是 平台 相关 的 . 


注意 图 片 类 中 大 量 使 用 引用 记 数 器 ,因此 对 图 片 类 进行 赋值 和 拷贝 的 操作 的 系统 开销 是 非常 小 
的 ,不 过 这 也 意味 着 对 一 个 图 片 的 更 改 可 能 会 影响 到 别 的 图 片 . 


所 有 的 图 片 类 都 使 用 下 表 列 出 的 标准 的 wxBitmapType 标 识 符 来 读 取 或 者 保存 图 片 数 据 : 





wxBITMAP_TYPE_BMP Windows 位 图 文件 (BMP). 
: 4= 次 洒 立 RA > 
wxBITMAP TYPE BMP RESOURCE Mwindows PI sh4T SCE 3 IRER AIR 
的 Windows 位 图 . 
wxBITMAP_TYPE_ICO Windows 图 标 文件 (ICO). 
: 4= 次 YSU ZS > 
wxBITMAP TYPE ICO RESOURCE 从 windows 可 执行 文件 资源 部 分 加 载 
= a 的 Windows 图 标 . 
wxBITMAP_TYPE_CUR Windows 光 标 文件 (CUR). 


从 windows 可 执行 文件 资源 部 分 加 载 
wxBITMAP_TYPE_CUR_RESOURCE 的 Windows 光 村. 


Pisa eA OPA Asma 1 TF A~a l /上 rm 上 7 一 na A LL 


wxBITMAP_TYPE_XBM 
wxBITMAP_TYPE_XBM_DATA 


wxBITMAP_TYPE_XPM 
wxBITMAP_TYPE_XPM_DATA 


wxBITMAP_TYPE_TIF 


wxBITMAP_TYPE_GIF 


wxBITMAP_TYPE_PNG 


wxBITMAP_TYPE_JPEG 


wxBITMAP_TYPE_PCX 
wxBITMAP_TYPE_PICT 


wxBITMAP_TYPE_PICT_RESOURCE 


wxBITMAP_TYPE_ICON_RESOURCE 


wxBITMAP_TYPE_ANI 
wxBITMAP_TYPE_IFF 
wxBITMAP_TYPE_MACCURSOR 


wxBITMAP_TYPE_MACCURSOR_RESOURCE 


wxBITMAP_TYPE_ANY 


Unix 平 台 上 使 用 的 XBM 单 色 图 片 . 
从 C++ 数据 中 构造 的 XBM 单 色 位 图 . 


XPM 格 式 图 片 , 最 好 的 支持 跨 平 台 并 
且 支 持 编译 到 应 用 程序 中 去 的 格式 . 


从 C++ 数据 中 构造 的 XPM 图 片 . 
TIFF 格 式 位 图 ,在 大 图 片 中 使 用 比较 


普通 . 


GIF 格式 图 片 ,最 多 支持 256 中 颜色 , 支 
持 透 明 . 


PNG 位 图 格式 , 一 个 使 用 广泛 的 图 片 
格式 ,支持 透明 和 alpha 通 道 ,没有 版 权 


问题 . 


JPEG 格 式 位 图 , 一 个 广泛 使 用 的 不 
缩 图 片 格式 ,支持 大 图 片 ,不 过 它 的 不 
缩 算法 是 有 损耗 压缩 ,因此 不 适合 对 
图 片 进行 反复 加 载 和 压缩 . 


PCX 图 片 格式 . 
Mac PICT 位 图 . 


从 可 执行 文件 资源 部 分 加 载 的 Mac 
PICT 位 图 . 


仅 在 Mac OS X 平 台 上 有 效 , 用 来 加 
载 一 个 标准 的 图 标 (比如 
wxICON_INFORMATION) 或 者 一 个 
图 标 资源 . 

Windows 动 画图 标 (ANI). 
IFF 位 图 文件 . 

Mac 光 标 文件 . 

从 可 执行 文件 资源 部 分 加 载 的 Mac 光 
标 . 


让 加 载 图 片 的 代码 自己 确定 图 片 的 格 


了 


10.2 使 用 wxBitmap 编 程 


你 可 以 使 用 wxBitmap 来 作 下 面 的 事情 : 


1. 通过 设备 上 下 文 将 其 画 在 一 个 窗口 上 . 
2. 在 某 些 类 (比如 wxBitmapButton, wxStaticBitmap, and wxToolBar) 中 将 其 作为 一 个 图 片 标 
KE 


3. 使 用 其 作为 双 缓 冲 区 (在 将 某 个 图 形 绘制 到 屏幕 上 之 前 先 绘制 在 一 块 缓冲 区 上 ). 


某 些 平台 (特别 是 windows 平 台 ) 上 限制 了 系统 中 bitmap 资 源 的 数目 ,因此 如 果 你 需要 使 用 很 多 的 
bitmap, 你 最 好 使 用 wxlmage 类 来 保存 它们 ,而 只 在 使 用 的 时 候 将 其 转化 成 bitmap. 
在 讨论 怎样 创建 wxBitmap 之 前 ,让 我 们 先 来 讨论 一 下 几 个 主要 的 画 数 ( 如 下 表 所 示 ) 


代表 一 个 bitmap, 可 以 通过 指定 宽度 和 高 度 ,或 者 指定 另外 一 个 
wxBitmap bitmap, 或 者 指定 一 个 wxlImage,XPM 数 据 (char*), 原始 数据 (char[])， 
或 者 一 个 指定 类 型 的 文件 名 的 方式 来 创建 . 


ConvertTolmage ， 转换 成 一 个 wxlmage, 保 留 透 明 部 分 . 


CopyFromlcon 从 一 个 wxlcon 创 建 一 个 wxBitmap. 

Create 从 图 片 数据 或 者 一 个 给 定 的 大 小 创建 一 个 bitmap. 

GetWidth, eR 

GetHeight 返回 图 片 大 小 . 

Getdepth 返回 图 片 颜色 深度 . 

Scotia 返回 绑 定 的 wxMask 对 象 或 者 NULL. 

GetSubBitmap 将 位 图 其 中 的 某 一 部 分 创建 为 一 个 新 的 位 图 . 

Beis 从 某 种 支持 格式 的 文件 加 载 或 者 保存 到 文件 里 . 
aveFile 


Ok 如 果 bitmap 的 数据 已 经 具 各 则 返回 True. 
创建 一 个 wxBitmap 
可 以 通过 下 面 的 几 个 途径 来 创建 一 个 wxBitmap 对 象 . 


你 可 以 直接 通过 默认 的 构造 函数 创建 一 个 不 包含 数据 的 bitmap, 不 过 你 几乎 不 能 用 这 个 bitmap 
作 任 何事 情 ,除非 你 调用 Create 或 者 LoadFile 或 者 用 另外 一 个 bitmap 赋 值 以 便 使 其 拥有 具体 的 
bitmap 数 据 . 


你 还 可 以 通过 指定 宽度 和 高 度 的 方法 创建 一 个 位 图 ,这 种 情况 下 创建 的 位 图 将 被 填充 以 随机 的 
颜色 ,你 需要 在 其 上 绘画 以 便 更 好 的 使 用 它 , 下 面 的 代码 演示 了 怎样 创建 一 个 200x100 的 图 片 并 
且 将 其 的 背景 刷新 为 白色 . 


// 使 用 当前 的 颜色 深度 创建 一 个 200x169 的 位 图 
wxBitmap bitmap(200, 100, -1); 
// 创建 一 个 内 存 设备 上 下 文 

wxMemoryDC dc; 

// 将 创建 的 图 片 和 这 个 内 存 设备 上 下 文 关联 
dc.SelectObject(bitmap); 

// 设置 背景 颜色 
dc.SetBackground(*wxWHITE_BRUSH ) ; 
// 绘制 位 图 背景 

dc.Clear(); 

// 解除 设备 上 下 文 和 位 图 的 关联 
dc.SelectObject (wxNul1Bitmap) ; 


你 也 可 以 从 一 个 wxImage 对 象 创建 一 个 位 图 ,并 且 保留 这 个 image 对 象 的 颜色 遮 罩 或 者 alpha 通 


道 : 


// 加 载 一 幅 图 像 

wxImage image(wxT("image.png"), wxBITMAP_TYPE_PNG) ) 
// 将 其 转换 成 bitmap 

wxBitmap bitmap(image); 


18 it CopyFromicona aA) LO t Btn XA E — bitmap: 


// 加 载 一 个 图 标 

wxIcon icon(wxT("image.xpm"), wxBITMAP_TYPE_XPM); 
// 将 其 转换 成 位 图 

wxBitmap bitmap; 

bitmap.CopyFromIcon(icon); 


或 者 你 可 以 通过 指定 类 型 的 方式 从 一 个 图 片 文件 直接 加 载 一 个 位 图 : 


// 从 文件 加 载 
wxBitmap bitmap(wxT("picture.png", wxBITMAP_TYPE_PNG); 
if (!bitmap.0k()) 


wxMessageBox(wxT("Sorry, could not load file.")); 


wxBitmap 可 以 加 载 所 有 的 可 以 被 WwxlImage 加 载 的 图 片 类 型 ,使 用 的 则 是 各 个 平台 定义 的 针对 特 
定 类 型 的 加 载 方法 .最 常用 的 图 片 格式 比如 "PNG, JPG,BMP 和 XPM" 等 在 各 个 平台 上 都 支持 读 
取 和 保存 操作 ,不 过 你 需要 确认 你 的 wxWidgets 在 编译 的 时 候 已 经 打开 了 对 应 的 支持 . 


目前 支持 的 图 形 类 型 处 理 范 数 如 下 表 所 示 : 


wxBMPHandler 
wxPNGHandler 
wxJPEGHandler 
wxGIFHandler 


wxPC XHandler 


wxPNMHandler 


wxTIFFHandler 
wxIFFHandler 
wxXPMHandler 
wxlCOHandler 
wxCURHandler 
wxANIHandler 


用 来 加 载 windows 位 图 文件 . 

用 来 加 载 PNG 类 型 的 文件 .这 种 文件 支持 透明 背景 以 及 alpha 通 道 . 
用 来 支持 JPEG 文 件 

因为 版 权 方 面 的 原因 , 仅 支 持 GIF 格 式 的 加 载 . 


用 来 支持 PCX. wxPCXHandler 会 自己 计算 图 片 中 颜色 的 数目 ,如 果 没 
有 超过 256 色 , 则 采用 8bits 颜 色 深 度 ,否则 就 采用 24 bits 颜 色 深 度 . 


用 来 支持 PNM 文 件 格式 . 对 于 加 载 来 说 PNM 格 式 可 以 支持 ASCII 和 
raw RGB 两 种 格式 .但 是 保存 的 时 候 久 支持 raw RGB 格式 . 


用 来 支持 TIFF. 

用 来 支持 IFF 格 式 . 

用 来 支持 XPM 格 式 . 

用 来 支持 windows 平 台 图 标 文件 . 

用 来 支持 windows 平 台 光 标 文件 . 

用 来 支持 windows 平 台 动 画 光 标 文件 . 


在 Mac OS X 平 台 


,还 可 以 通过 指定 wxBITMAP_TYPE_PICT_RESOURCE 来 加 载 一 个 PICT 


如 果 你 希望 在 不 同 的 平台 上 从 不 同 的 位 置 加 载 图 片 ,你 可 以 使 用 wxBITMAP 宏 ,如 下 所 示 : 


#if !defined(__WXMSW__) && !defined(__WXPM_) 
#include "picture. xpm" 

#endif 

wxBitmap bitmap(wxBITMAP(picture) ); 


这 将 使 得 程序 在 windows 和 OS/2 平 台 上 从 资源 文件 中 加 载 图 片 ,而 在 别 的 平台 上 , 则 从 一 个 
picture_xpm 交 量 中 加 载 xpm 格 式 的 图 片 ,因为 XPM 在 所 有 的 平台 上 都 支持 ,所 以 这 种 使 用 方法 
并 不 常见 . 


设置 一 个 wxMask 


每 个 wxBitmap 对 象 都 可 以 指定 一 个 wxMask, 所 谓 wxMask 指 的 是 一 个 单 色 图 片 用 来 指示 原 图 中 
的 透明 区 域 .如 果 你 要 加 载 的 图 片 中 包含 透明 区 域 信 息 ( 比 如 XPM,PNG 或 者 GIF 格式 ), 那 么 
wxMask 将 被 自动 创建 ,另外 你 也 可 以 通过 代码 创建 一 个 wxMask 然 后 调用 SetMaski 20 3 All 
对 应 的 wxBitmap 对 象 相关 连 .你 还 可 以 从 wxBitmap 对 象 创建 一 个 wxMask, 或 者 通过 给 一 个 
wxBitmap 对 象 指 定 一 种 透明 颜色 来 创建 一 个 wxMask 对 象 . 


下 面 的 代码 创建 了 一 个 拥有 透明 色 的 奈 阶 位 图 mainBitmap, 它 的 大 小 是 32x32 象 素 ,原始 图 形 从 
imageBits 数 据 创 建 , 庶 晶 图 形 从 maskBits 创 建 , 遮 淖 中 1 代表 不 透明 ,0 代表 透明 颜色 . 


static char imageBits[] = { 255, 255, 255, 255, 31, 
255, 255, 255, 31, 255, 255, 255, 31, 255, 255, 255, 
31, 255, 255, 255, 31, 255, 255, 255, 31, 255, 255, 
255, 31, 255, 255, 255, 31, 255, 255, 255, 25, 243, 
255, 255, 19, 249, 255, 255, 7, 252, 255, 255, 15, 254, 
255, 255, 31, 255, 255, 255, 191, 255, 255, 255, 255, 
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 
255 }; 

static char maskBits[] = { 240, 1, 0, 0, 240, 1, 
0, ©, 240, 1, 0, 0, 240, 1, ©, 0, 240, 1, ©, 0, 240, 1, 
0, ©, 240, 1, 0, 0, 240, 1, 0, 0, 255, 31, 0, 0, 255, 
31, ©, 0, 254, 15, ©, ©, 252, 7, 0, 0, 248, 3, 0, O, 
240, 1, 0, 0, 224, ©, ©, ©, 64, ©, ©, ©, ©, ©, O, O, @, 


0, ©, ©, ©, ©, 9, 0, O, O, ©, ©, ©, O, ©, O, O, ©, 9, 
9, ©, 0, ©, ©, 9, ©, O, 0, ©, 0, ©, O, ©, O, ©, ©, 9, 
9, ©, 0, ©, ©, 9, ©, 0, 0, ©, ©, ©, ©, ©, ©, ©, ©, Ọ, 
0, 0, 0, 0, 0 }; 


wxBitmap mainBitmap(imageBits, 32, 32); 
wxBitmap maskBitmap(maskBits, 32, 32); 
mainBitmap.SetMask(new wxMask(maskBitmap) ); 


XPM 图 形 格式 


在 使 用 小 的 需要 支持 透明 的 图 片 ( 比 如 工具 栏 上 的 小 图 片 或 者 notebook 以 及 树 状 控件 上 的 小 
片 ) 的 时 候 ,wxWidgets 的 程序 员 通 常 偏爱 使 用 XPM 格 式 , 它 的 最 大 的 特点 是 采用 C/C++ 语言 的 语 
法 , 既 可 以 被 程序 动态 加 载 ,也 可 以 直接 编译 到 可 执行 代码 中 去 ,下 面 是 一 个 例子 : 


// 你 也 可 以 用 #include "open. xpm" 
static char *open_xpm[] = { 
/* 列 数 行 数 颜色 个 数 每 个 象 素 的 字符 个 数 */ 
"16 155 1", 
c None", 
. C Black", 
"X c Yellow", 
c Gray100", 
c #bfbf00", 
/* RR */ 


" .OXoXoXoXo. 
" .XoXoXoXoX. ee 


" ,.X0X.000000000.", 
" ,00.000000000. ", 
" .X.000000000. ", 
" ..000000000. y 


wxBitmap bitmap(open_xpm); 


正如 你 看 到 的 那样 ,XPM 是 使 用 字符 编码 的 .在 图 片 数据 前 面 ,有 一 个 调 色 板 区 域 ,使 用 字符 和 颜 
色 对 应 的 方法 ,颜色 既 可 以 用 标准 标识 符 表 示 , 也 可 以 用 16 进 制 的 RGB 值 表示 ,使 用 关键 字 None 
来 表示 透明 区 域 .尽管 在 windows 系 统 上 ,XPM 并 不 被 大 多 数 的 图 形 处 理工 具 支 持 ,不 过 你 还 是 可 
以 通过 一 些 工 具 把 PNG 格 式 转 换 成 XPM 格 式 ,比如 DialogBlocks 自 带 的 ImageBlocks 工 具 , 或 者 
你 可 以 直接 使 用 wxWidgets 编 写 一 个 你 自己 的 转换 工具 . 


使 用 位 图 绘画 


使 用 位 图 绘画 的 方式 有 两 种 ,你 可 以 使 用 内 存 设备 上 下 文 绑 定 一 个 位 图 ,然后 使 用 wxDC::Blit 画 
数 ,也 可 以 直接 使 用 wxDC:: DrawBitmap 画 数 ,前 者 允许 你 使 用 位 图 的 一 部 分 进行 绘制 .在 两 种 方 
式 下 ,如 果 这 个 图 片 支 持 透 明 或 者 alpha 通 道 ,你 都 可 以 通过 将 最 后 一 个 参数 指定 为 True 或 者 
False 来 打开 或 者 关闭 透明 支持 . 


这 两 种 方法 的 用 法 如 下 : 


// Draw a bitmap using a wxMemoryDC 

wxMemoryDC memDC,; 

memDC.SelectObject(bitmap) ; 

// Draw the bitmap at 100, 100 on the destination DC 


destDC.Blit(100, 100, // Draw at (100, 100) 
bitmap.GetWidth(), bitmap.GetHeight(), // Draw full bitmap 
& memDC, // Draw from memDC 
O, O, // Draw from bitmap origin 
wxCOPY, // Logical operation 
true); // Take mask into account 


memDC.SelectObject (wxNullBitmap) ; 
// Alternative method: use DrawBitmap 
destDC.DrawBitmap(bitmap, 100, 100, true); 


第 五 章 ," 绘 画 和 打印 "中 对 使 用 bitmap 绘 画 有 更 详细 的 描述 . 
打包 位 图 资源 


如 果 你 鲁 是 一 个 windows 平 台 的 程序 员 , 你 可 能 习惯 从 可 执行 文件 的 资源 部 分 加 载 一 幅 图 片 , 当 
然 在 wxWidgets 中 也 可 以 这 样 作 , 你 只 需要 指定 一 个 资源 名 称 一 个 资源 类 型 
wxBITMAP_TYPE_BMP_RESOURCE, 不 过 这 种 作法 是 平台 相关 的 .你 可 能 更 倾向 于 使 用 另外 
一 种 平台 无 关 的 解决 方案 . 


一 个 可 移植 的 方法 是 ,你 可 以 将 你 用 到 的 所 有 数据 文件 ,包括 HTML 网 页 ,图 片 或 者 别 的 任何 类 型 
的 文件 压缩 在 一 个 zip 文 件 里 ,然后 你 可 以 用 wxWidgets 提 供 的 虚拟 文件 系统 对 加 载 这 个 zip 文 件 
的 其 中 任何 一 个 或 几 个 文件 ,如 下 面 的 代码 所 示 : 


// 创建 一 个 文件 系统 

wxFileSystem*fileSystem = new wxFileSystem; 
wxString archiveURL(wxT("myapp.bin") ); 

wxString filename(wxT("myimage.png") ); 

wxBitmapType bitmapType = wxBITMAP_TYPE_PNG; 

// 创建 一 个 URL 

wxString combinedURL(archiveURL + wxString(wxT("#zip:")) + filename); 
wxImage image; 

wxBitmap bitmap; 

// 打开 压缩 包 中 的 对 应 文件 

wxFSFile* file = fileSystem->OpenFile(combinedURL ) ; 
if (file) 


wxInputStream* stream = file->GetStream(); 
// Load and convert to a bitmap 
if (image.LoadFile(* stream, bitmapType) ) 
bitmap = wxBitmap(image); 
delete file; 
delete fileSystem; 
if (bitmap.0k()) 
{ 


} 


更 多 关于 虚拟 文件 系统 的 信息 请 参考 第 14 章 :文件 和 流 操作 . 


10.3 使 用 wxlcon 编 程 


一 个 wxlcon 代 表 一 个 小 的 位 图 , 它 总 有 一 个 透明 遮 罩 , 它 的 用 途 包括 : 


° 设置 frame 窗口 或 者 对 话 框 的 图 标 
e 通过 wxlmageList 类 给 wxTreeCtrl, wxListCtrl 或 者 wxNotebook 提 供 图 标 (更 多 信息 请 参考 
最 后 一 章 ) 
。 使 用 wxDC::Drawlcon 画 数 在 设备 上 下 文中 绘制 一 个 图 标 
下 表 列 出 了 图 标 类 的 主要 成 员 琅 数 
CO 标 类 可 以 通过 指定 另外 一 个 图 标 类 的 方式 ,指定 XPM 数 据 (char**) 
的 方式 , 原始 数据 (char[]) 的 方式 ,或 者 文件 名 及 文件 类 型 的 方式 创建 . 
CopyFromBitmap ”从 wxBitmap 类 创建 一 个 图 标 . 


Sasa 返回 图 标的 大 小 . 

Getdepth 返回 图 标的 颜色 深度 . 

LoadFile 从 文件 加 载 图 标 . 

Ok 在 图 标 数 据 已 经 具备 的 时 候 返 回 True. 


创建 一 个 wxlcon 


wxlcon 可 以 使 用 XPM 数 据 创建 ,或 者 从 一 个 wxBitmap 对 象 中 创建 ,或 者 从 文件 (比如 一 个 Xpm 文 
件 ) 中 读 取 .wxWidgets 也 提供 了 类 似 于 前 一 小 节 提 到 的 wxBITMAP 类似 的 宏 , 用 来 从 一 个 平台 相 
关 的 资源 中 获取 图 标 . 


在 windows 平 台 上 ,LoadFile 以 及 同等 性 质 的 操作 可 以 使 用 的 文件 类 型 包括 BMP 图 片 和 ICO 文 


换 为 一 个 图 标 . 


而 在 Mac OSX 和 Unix/Linux 的 GTK+ 版 本 中 ,wxlcon 可 以 识别 的 图 片 类 型 和 wxBitmap 可 以 识别 
的 图 片 类 型 是 一 样 的 . 


下 面 代 码 演示 了 创建 一 个 wxlcon 对 象 的 几 种 方法 : 


// 方法 1: 从 XPM 数 据 创建 

#include "iconi.xpm" 

wxIcon icon1(icon1_xpm); 

// 方法 2: 从 一 个 IC0 资 源 中 创建 (Window and OS/2 only) 
wxIcon icon2(wxT("icon2")); 

// 方法 3: 从 一 个 图 片 文件 中 (Windows and 0S/2 only) 

// 如 果 你 的 图 片 包含 多 个 图 标 你 可 以 指定 单个 图 标的 宽度 

wxIcon icon3(wxT("icon3.ico"), wxBITMAP_TYPE_ICO, 16, 16); 
// 方法 4: 从 位 图 创建 

wxIcon icon4; 

wxBitmap bitmap(wxT("icon4.png"), wxBITMAP_TYPE_PNG); 
icon4.CopyFromBitmap(bitmap) ; 


使 用 wxlcon 


下 面 的 代码 演示 了 wxlcon 的 三 种 使 用 方法 :设置 窗口 图 标 ,增加 到 一 个 图 片 列 表 或 者 绘制 在 某 个 
设备 上 下 文 上 


#include "myicon.xpm" 

wxIcon icon(myicon_xpm); 

// 1: 设置 窗口 图 标 

frame->SetIcon(icon); 

// 2: 增加 到 wxImageList 

wxImageList* imageList = new wxImageList(16, 16); 
imageList->Add(icon) ; 

// 3: 在 (10，109) 的 位 置 绘制 

wxClientDC dc(window); 

dc.DrawIcon(icon, 10, 10); 


将 某 个 图 标 绑 定 到 应 用 程序 


将 某 个 图 标 绑 定 到 应 用 程序 ,以 便 系 统 可 以 显示 这 个 图 标 在 合适 的 位 置 使 得 用 户 可 以 通过 点 击 
图 标的 方式 打开 应 用 程序 ,这 个 工作 wxWidgets 是 做 不 到 的 .这 是 极 少 的 你 需要 在 不 同 的 平台 
用 不 同 的 技术 的 领域 中 的 一 个 . 


在 windows 平 台 上 ,你 需要 在 makefile 中 增加 一 个 资源 文件 (扩展 名 是 .rc), 并 且 在 这 个 资源 文件 中 
指定 一 个 图 标 区 域 ,如 下 所 示 : 


aardvarkpro ICON aardvarkpro.ico 
#include "wx/msw/wx.rc" 


在 这 里 , aardvarkpro.ico 就 是 这 个 和 应 用 程序 绑 定 的 图 标的 名 称 , 它 可 以 有 多 种 分 辨 率 和 颜色 深 
度 (典型 的 大 小 包括 48x48,32x32 和 16x16). 当 windows 的 资源 管理 器 需要 显示 某 个 图 标的 时 候 
它 将 使 用 子 母 顺序 排 在 第 一 个 的 那个 图 标 , 因 此 你 最 好 给 确定 要 作为 应 用 程序 图 标的 那个 图 标 
的 名 称 前 面 加 几 个 a 子 母 以 便 按 照 子 母 顺 序 它 排 在 前 面 ,否则 你 的 应 用 程序 可 能 绑 定 的 是 你 不 期 
望 的 图 标 . 


在 Mac 系 统 上 ,你 需要 准备 一 个 应 用 程序 包 , 其 中 包含 一 些 ICNS 文 件 .参考 第 20 章 "让 你 的 程序 更 
完美 ", 来 获得 关于 程序 包 更 多 的 信息 ,其 中 的 主要 文件 Info.plist 文 件 看 上 去 应 该 象 下 面 的 额 样子 : 


<key>CFBundleDocumentTypes</key> 
<array> 
<dict> 
<key>CFBundleTypeExtensions</key> 
<array> 
<string>pjd</string> 
</array> 
<key>CFBundleTypeIconFile</key> 
<string>dialogblocks-doc.icns</string> 
<key>CFBundleTypeName</key> 
<string>pjdfile</string> 
<key>CFBundleTypeRole</key> 
<string>Editor</string> 
</dict> 
</array> 
<key>CFBundleIconFile</key> 
<string>dialogblocks-app.icns</string> 


应 用 程序 图 标 和 应 用 程序 相关 的 文档 类 型 图 标 是 由 CFBundlelconFile 和 
CFBundleTypelconFile 属 性 指定 的 .你 可 以 直接 用 Apple 提 供 图 标 编辑 器 编辑 ICNS 文 件 ,不 过 如 
果 你 希望 所 有 的 平台 使 用 同样 的 图 标 ,你 最 好 现 用 PNG 图 片 创 建 各 种 大 小 的 图 标 ,然后 再 将 它 粘 
贴 到 各 个 平台 上 的 图 标 编辑 器 中 ,要 确保 PNG 使 用 的 透明 遮 罩 颜 色 和 各 个 工具 使 用 的 透明 颜色 
相 一致 . 


而 在 linux 平 台 上 ,Gnome 桌 面 系统 和 KDE 桌 面 系 统 则 各 自 拥 有 自己 的 图 标 提供 体系 ,我 们 将 在 
第 20 章 进行 简要 的 描述 . 


10.4 使 用 wxCursor 编 程 


光标 用 来 指示 鼠标 指针 当前 的 位 置 .你 可 以 给 某 个 窗口 指定 不 同 的 光标 以 便 提示 用 户 这 个 窗口 
期 待 某 种 类 型 的 鼠标 操作 .和 图 标 一 样 ,光标 也 是 一 种 始终 带 有 透明 遮 罩 的 小 图 片 ,可 以 使 用 一 般 
的 构造 本 数 或 者 是 平台 相关 的 构造 画 数 来 创建 .其 中 的 一 些 构造 本 数 还 需要 相对 于 整个 图 片 的 
左上 角 指 定 一 个 热点 位 置 , 当 最 标点 击 的 时 候 ,热点 所 在 的 位 置 特 作为 鼠标 点 击 的 位 置 . 


下 表 列 举 了 光标 相关 的 函数 


ee 人 


Ok 如 果 光 标 数据 已 经 具备 , 则 返回 True. 
创建 一 个 光标 
创建 光标 最 简单 的 方法 是 通过 系统 提供 的 光标 标识 符 ,如 下 面 的 例子 所 示 : 
wxCursor cursor(WxCURSOR WAIT); 


下 表 列 出 了 目前 支持 的 光标 标识 符 和 它们 的 光标 的 祥子 (依照 平台 的 不 同 会 有 些 变化 ) 


wxCURSOR_ARROW 


wxCURSOR_RIGHT_ARROW 
wxCURSOR_BLANK 


wxCURSOR_BULLSEYE 
wxCURSOR_CROSS 


wxCURSOR_HAND 


wxCURSOR_IBEAM 
wxCURSOR_LEFT_BUTTON 
wxCURSOR_MAGNIFIER 


wxCURSOR_MIDDLE_BUTTON 


wxCURSOR_NO_ENTRY 
wxCURSOR_PAINT_BRUSH 
wxCURSOR_PENCIL 
wxCURSOR_POINT_LEFT 


wxCURSOR_POINT_RIGHT 


wxCURSOR_QUESTION_ARROW 


wxCURSOR_RIGHT_BUTTON 


wxCURSOR_SIZENESW 
wxCURSOR_SIZENS 
wxCURSOR_SIZENWSE 
wxCURSOR_SIZEWE 
wxCURSOR_SIZING 
wxCURSOR_SPRAYCAN 


wxCURSOR_WAIT 
wxCURSOR_WATCH 


wxCURSOR_ARROWWAIT 
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标准 光标 . 
标准 反 向 光标 . 


| 字 光 标 . 

按 左 键 (GTK+ only). 

放大 镜 . 

按 中 键 ( 译 者 注 : 原 书 图 片 有 误 ) (GTK+ 


带 问 号 的 箭头 . 


按 右键 ( 译 者 注 : 图 片 有 误 ) (GTK+ 
only). 


东北 到 西南 伸缩 . 
南北 伸缩 . 
西北 到 东南 伸缩 . 
东西 伸缩 . 
一 般 伸 缩 . 


画 刷 . 


你 还 可 以 使 用 预定 义 光标 指针 wxSTANDARD_CURSOR, wxHOURGLASS_CURSOR 和 
wxCROSS_CURSOR. 


另外 在 windows 和 Mac 平 台 上 还 可 以 从 对 应 的 资源 文件 中 加 载 光标 : 


//windows 平 台 

wxCursor cursor(wxT("cursor_resource"), wxBITMAP_TYPE_CUR_RESOURCE, 
hotSpotX, hotSpoty); 

// Mac 平 台 

wxCursor cursor(wxT("cursor_resource"), wxBITMAP_TYPE_MACCUR_RESOURCE); 


你 还 可 以 通过 wxlImage 对 象 创 建 光标 ,而 "热点 " 则 要 通过 wxlmage::SetOptionlnt 男 数 设置 .之 所 
以 要 设置 热点 , 是 因为 很 多 光标 不 太 适 合 使 用 默认 的 左上 角 作 为 热点 ,比如 对 于 十 字 光 标 来 说 ， 
你 可 能 希望 将 其 十 字 交 叉 的 地 方 作 为 热点 .下 面 的 代码 演示 了 怎样 从 一 个 PNG 文 件 中 产生 设置 
了 热点 的 光标 : 


// 用 wxImage 创 建 光 标 

wxImage image(wxT("cursor.png"), wxBITMAP_TYPE_PNG); 
image.SetOptionInt (wxIMAGE_OPTION_CUR_HOTSPOT_X, 5); 
image .SetOptionInt (wxIMAGE_OPTION_CUR_HOTSPOT_Y, 5); 
wxCursor cursor(image); 


使 用 wxCursor 


每 个 窗口 都 可 以 设置 一 个 对 应 的 光标 ,这 个 光标 在 鼠标 进入 这 个 窗口 的 时 候 显示 ,如 果 一 个 窗口 
没有 设置 光标 ,其 父 窗口 的 光标 将 被 显示 ,如 果 所 有 的 父 窗口 都 没有 设置 光标 , 则 系统 默认 光标 被 


显示 : 
使 用 下 面 的 代码 给 窗口 设置 一 个 光标 : 


window->SetCursor (wxCursor (wxCURSOR_WAIT) ); 


使 用 wxSetCursorEvent 


在 windows 系 统 或 者 是 Mac OS X 系 统 上 ,有 一 些小 地 方 我 们 需要 注意 一 下 . 举 个 例子 ,如 果 你 自 
己 实现 了 一 个 容器 类 ,比方 说 是 一 个 分 割 窗口 ,并 且 给 它 设置 了 一 个 特殊 的 光标 (比如 说 
wxCURSOR_WE 用 来 表明 某 个 分 割 条 是 可 以 被 拉动 的 ), 然 后 你 在 这 个 分 割 窗口 中 放置 了 两 个 
子 窗口 ,如 果 你 没有 给 这 两 个 子 窗口 设置 光标 的 话 , 当 光 标 在 子 窗口 上 移动 时 ,它们 可 能 会 不 恰当 
的 显示 其 父 窗口 ,那个 wxCURSOR_WE 光 标 .而 本 来 你 是 希望 只 有 在 鼠标 移动 到 分 割 条 上 的 时 
候 才 显示 的 . 


告诉 wxWidgets 某 个 光标 只 应 该 在 某 种 情况 下 被 显示 ,你 可 以 增加 一 个 wxSetCursorEvent 事 
件 的 处 理 画 数 , 这 个 事件 在 Windows 和 Mac 平 台 上 , 当 需 要 设置 光标 的 时 候 ( 通 常 是 妃 标 在 窗口 间 
移动 的 时 候 ) 被 产生 .在 这 个 事件 处 理 画 数 中 可 以 调用 wxSetCursorEvent::SetCursor 来 设置 一 
个 特殊 的 光标 .如 下 所 示 : 


BEGIN_EVENT_TABLE(wxSplitterWindow, wxWindow) 
EVT_SET_CURSOR(wxSplitterWindow: :OnSetCursor ) 

END_EVENT_TABLE( ) 

// 指示 光标 只 应 该 被 设置 给 分 割 条 

void wxSplitterWindow: :OnSetCursor(wxSetCursorEvent& event) 


{ 
if ( SashHitTest(event.GetX(), event.GetY(), 0) ) 
// 使 用 默认 的 处 理 
event.Skip(); 
} 
//else: 什 么 也 不 作 , 换 名 话说, 不 调用 Skip . 则 事件 表 不 会 被 继续 搜索 


在 这 个 例子 中 , 当 妃 标 指 针 移 过 分 割 条 的 时 候 ,SashHitTest 画 数 返 回 True, 因 此 Skip 函 数 被 调用 ， 
事件 表 调 用 失败 ,这 和 没有 定义 这 个 事件 表 的 效果 是 一 样 的 ,导致 wxWidgets 象 往常 一 样 显示 指 
定 给 窗口 的 光标 (WxXCURSOR_WE). 而 如 果 SashHitTest 函 数 返回 False, 则 表明 光标 是 在 子 窗口 
上 移动 ,这 时 候 应 该 不 显示 我 们 指定 的 光标 ,因此 我 们 不 调用 Skip 范 数 ,让 事件 表 匹 配 成 功 , 则 事 
件 表 将 不 会 在 继续 匹配 ,这 将 使 得 wxWidgets 认 为 这 个 窗口 没有 被 指定 光标 ,因此 .在 这 种 情况 
下 ,即使 子 窗口 自己 没有 光标 ( 象 wxTextCtrl 这 种 控件 ,一 般 系统 会 指定 一 个 它 自 己 的 光标 ,不 过 
wxWidgets 对 这 个 是 不 感知 的 ), 也 将 不 会 使 用 我 们 指定 给 父 窗口 的 光标 . 


10.5 使 用 wxlmage 编 程 


你 可 以 使 用 wxlmage 对 图 形 进行 一 些 平 台 无 关 的 调整 ,或 者 将 其 作为 图 片 加 载 和 保存 的 中 间 步 
又 .图 片 在 wxImage 中 是 按照 每 一 个 象 素 使 用 一 个 分 别 代表 红色 ,绿色 和 蓝 色 的 字 节 的 格式 保存 
的 ,如 果 图 片 包含 alpha 通 道 , 则 还 会 占用 额外 的 一 个 字 节 . 


wxlmage 主 要 的 函数 如 下 : 


wxlmage 


ConvertAlphaToMask 
ConvertToMono 


Copy 
Create 


Destroy 
GeTData, SetData 
GetlmageCount 


GetOption, 
GetOptionInt, 
SetOption, HasOption 


GetSublmage 
GetWidth, GetHeight 


Getred, GetGreen, 
GetBlue, SetRGB, 
GetAlpha, SetAlpha 


HasMask, 
GetMaskRed, 
GetMaskGreen, 
GetMaskBlue, 
SetMaskColour 


LoadFile, SaveFile 
Mirror 

Ok 

Paste 

Rotate, Rotate90 
SetMaskFromimage 


Scale, Rescale 


wxlmage 的 创建 方法 包括 :指定 宽度 和 高 度 , 从 另外 一 幅 图 片 
创建 , 使 用 XPM 数 据 , 图 片 元 数据 (char[]) 和 可 选 的 alpha 通 道 
数据 ,文件 名 及 其 类 型 ,以 及 通过 输入 流 等 多 种 方式 创建 . 

将 alpla 通 道 ( 如 果 有 的 话 ) 转 换 成 一 个 透明 遮 晶 . 
转换 成 一 个 黑白 图 片 . 

返回 一 个 不 使 用 引用 记 数 器 的 完全 一 样 的 拷贝. 


me een 片 ,可 选 的 参数 指明 是 否 初始 化 图 片 数 
局 . 


如 果 没 有 人 再 使 用 的 话 , 释 放 内 部 数据 . 
获取 和 设置 内 部 数据 指针 (unsigned char*). 
返回 一 个 文件 或 者 流 中 的 图 片 个 数 . 


获取 , 设置 和 测试 某 个 选项 是 否 设置 . 


将 图 片 的 一 部 分 返回 为 一 个 新 的 图 像 . 
返回 图 片 大 小 . 


获得 和 指定 某 个 象 素 的 RGB 以 及 Alpha 通 道 的 值 . 


用 来 测试 图 像 是 否 有 一 个 遮 罩 , 以 及 遮 罩 颜 色 的 RGB 值 或 者 整 
个 颜色 的 值 . 


各 种 图 片 格式 文件 的 读 取 和 保存 操作 . 

在 各 种 方向 上 产生 镜像 ,返回 一 个 新 图 片 . 

判断 图 片 是 否 已 初始 化 . 

将 某 个 图 片 粘贴 在 这 个 图 片 的 指定 位 置 . 

旋转 图 片 ,返回 一 个 新 图 片 . 

通过 指定 的 图 片 和 透明 颜色 产生 一 个 遮 四 并 且 设 置 这 个 遮 罩 . 
缩放 产生 一 个 新 图 片 或 者 缩放 本 图 片 . 


加 载 和 保存 图 像 


wxlmage 可 以 读 取 和 保存 各 种 各 样 的 图 片 格式 ,并 且 使 用 图 像 处理 过 程 来 增加 扩展 的 能 力 .其 它 
的 图 像 类 (比如 wxBitmap) 在 某 个 平台 不 具备 义理 某 种 图 形 格式 的 能 力 的 时 候 ,也 通常 使 用 的 都 
是 wxlImage 的 图 象 处 理 过 程 来 加 载 特定 格式 的 图 形 . 


本 章 第 二 小 节 中 展示 了 wxWidgets 支 持 的 各 种 图 形 处 理 过 程 .其 中 wxBMPHandler 是 默认 支持 
的 ,而 要 支持 其 它 的 图 形 格式 义理 ,就 需要 使 用 wxlmage::AddHandler 函 数 增加 对 应 的 图 形 处 理 
过 程 或 者 使 用 wxlnitAlllmageHandlers 增 加 所 有 支持 的 图 形 义理 过 程 . 


如 果 你 只 需要 特定 的 图 形 格式 支持 ,可 以 在 Onlnit 函 数 中 使 用 类 似 下 面 的 代码 : 


#include "wx/image.h" 

wxImage: :AddHandler( new wxPNGHandler ); 

wxImage: :AddHandler( new wxJPEGHandler ); 
wxImage: :AddHandler( new wxGIFHandler ); 

wxImage: :AddHandler( new wxXPMHandler ); 


或 者 ,你 可 以 简单 的 调用 : 


wxInitAllImageHandlers(); 


下 面 演示 了 几 种 从 文件 或 者 流 读 取 图 片 的 方式 ,注意 在 实际 使 用 过 程 中 ,最 好 使 用 绝对 路 径 以 避 
免 依赖 于 当前 路 径 的 设置 : 


// 使 用 构造 画 数 指定 类 型 来 读 取 图 像 
wxImage image(wxT("image.png"), wxBITMAP_TYPE_PNG) ) ; 
if (image.Ok()) 


} 

// 不 指定 图 像 类 型 一 般 也 能 正常 工作 

wxImage image(wxT("image.png")); 

// 使 用 两 步 法 创建 图 像 

wxImage image; 

if (image.LoadFile(wxT("image.png"))) 
{ 


} 
// 如 果 一 个 文件 包含 两 副 图 片 Two-step loading with an index into a multi-image file: 
// 下 面 演示 选择 第 2 副 加 载 
wxImage image; 
int imageCount = wxImage::GetImageCount (wxT("image.tif")); 
if (imageCount &gt; 2) 
image.LoadFile(wxT("image.tif"), wxBITMAP_TYPE_TIFF, 2); 
// 从 文件 流 加 载 图 片 
wxFileInputStream stream(wxT("image.tif")); 
wxImage image; 
image.LoadFile(stream, wxBITMAP_TYPE_TIF); 
// 保存 到 一 个 文件 
image.SaveFile(wxT("image.png")), wxBITMAP_TYPE_PNG); 
// 保存 到 一 个 流 
wxFileOutputStream stream(wxT("image.tif")); 
image.SaveFile(stream, wxBITMAP_TYPE_TIF); 


除了 XPM 和 PCX 格 式 以 外 ,其 它 的 图 片 格式 都 将 以 24 位 颜色 深度 保存 ( 译 者 注 :GIF 格 式 因为 版 权 
方面 的 原因 不 支持 保存 到 文件 ), 这 两 种 格式 的 图 形 义理 过 程 将 会 计算 实际 的 颜色 个 数 从 而 选择 
相应 的 颜色 深度 .JPEG 格 式 还 拥有 一 个 质量 选项 可 供 设置 . 它 的 值 的 范围 为 从 0 到 100,0 代 表 最 
低 的 图 片 质量 和 最 高 的 压缩 比 ,100 则 代表 最 高 的 图 片 质量 和 最 低 的 压缩 比 .如 下 所 示 : 


// 设置 一 个 合理 的 质量 压缩 比 
image .SetOption(wxIMAGE_OPTION_QUALITY, 80); 
image.SaveFile(wxT("picture.jpg"), wxBITMAP_TYPE_JPEG); 


Fy AMOR LAXPM AS RRT E Hat E A Aa, Fe Se (FA wxImage::SetOption Nik E — AE E 
否则 ,义理 函数 不 知道 该 用 什么 名 称 命名 对 应 的 C 变 量 . 


// 保存 XPM 到 流 格 式 
image.SetOption(wxIMAGE_OPTION_FILENAME, wxT("myimage")); 
image.SaveFile(stream, wxBITMAP_TYPE_XPM) ; 


TELEKA A AEM EEA" xp". 


有 两 种 方式 设置 一 XImage jy eth NE 图 像 :使 用 颜色 遮 罩 或 者 alpha 通 道 .一 种 颜色 可 以 被 指 
定 为 透明 颜色 ,通过 这 种 方法 在 将 wxlImage 转 换 成 wxBitmap 的 时 候 可 以 很 容易 的 制作 一 个 透明 
Ss. 


wxlmage 也 支持 alpha 通 道 数 据 , 在 每 一 个 象 素 的 RGB 颜色 之 外 来 由 另外 一 个 字 节 用 来 指示 
alpha 通 道 的 值 ,0 代表 完全 透明 ,255 则 代表 完全 不 透明 .中 间 的 值 代表 半 透 明 . 


不 是 所 有 的 图 片 都 用 有 alpha 通 道 数据 的 ,因此 在 使 用 GetAlpha 枉 数 之 前 ,点 该 使 用 HasAlpha 画 
数 来 判断 图 像 是 否 拥 有 alpha 通 道 数 据 . 到 目前 为 止 ,只 有 PNG 文 件 或 者 调用 SetAlpha 设 置 了 
alpha 通 道 的 图 像 才 拥有 alpha 通 道 数 据 .保存 一 个 带 有 alpha 通道 的 图 像 目前 还 不 被 支持 .绘制 
一 个 拥有 alpha 通 道 的 方法 是 先 将 其 转换 成 wxBitmap 然 后 使 用 wxDC::DrawBitmap 或 者 wxDC:: 
Blithe XX. 


RAYE 2538 an TBE an A 3 0) SE — TSA wximage, 6 = ie 89, 7a TFB 
形 区 域 : 


// 创建 一 个 有 颜色 掩 码 的 wxBitmap 

// 首先 , 在 这 个 wxBitmap 上 绘画 

wxBitmap bitmap(400, 400); 
wxMemoryDC dc; 
dc.SelectObject(bitmap); 
dc.SetBackground( *wxBLUE_BRUSH) ; 
dc.Clear(); 

dc.SetPen( *wxRED_PEN); 
dc.SetBrush(*wxRED_BRUSH) ; 
dc.DrawRectangle(50, 50, 200, 200); 
dc.SelectObject (wxNul1Bitmap) ; 

// 将 其 转换 成 WxImage 

wxImage image = bitmap.ConvertToImage(); 
// 设置 掩 码 颜 色 
image.SetMaskColour(255, 0, 0); 


在 下 面 的 例子 中 ,使 用 从 一 个 图 片 创建 颜色 遮 罩 的 方式 ,其 中 image.bmp 是 原始 图 像 ,而 
mask.bmp 则 是 一 个 掩 码 图 像 ,在 后 者 中 所 有 透明 的 部 分 都 是 黑色 显示 的 . 


// 加 载 一 副 图 片 和 它 的 掩 码 遮 章 

wxImage image(wxT("image.bmp"), wxBITMAP_TYPE_BMP); 
wxImage maskImage(wxT("mask.bmp"), wxBITMAP_TYPE_BMP); 
// 从 后 者 创建 一 个 遮 罩 并 且 设置 给 前 者 . 
image.SetMaskFromImage(maskImage, ©, ©, 0); 


如 果 你 加 载 的 图 片 本 身 含 有 透明 颜色 ,你 可 以 检测 并 且 直 接 创 建 遮 罩 : 


// 加 载 透明 图 片 

wxImage image(wxT("image.png"), wxBITMAP_TYPE_PNG) ) ; 
获取 掩 码 

if (image.HasMask()) 


wxColour maskColour(image.GetMaskRed(), 
image.GetMaskGreen(), 
image.GetMaskBlue()); 


wxlImage 支 持 缩放 ,旋转 以 及 镜像 等 多 种 变形 方式 ,下 面 各 举 一 些 例子 


// 把 原始 图 片 缩放 到 200x200, 并 保存 在 新 的 图 片 里 
// 原 图 保持 不 变 ， 

wxImage image2 = image1.Scale(200, 200); 
// 将 原 图 缩放 到 200x200 
image1.Rescale(200, 200); 

// 旋转 固定 角度 产生 新 图 片 . 

// 原 图 片 保持 不 变 ， 

wxImage image2 = image1.Rotate(0.5); 

// 顺 时 针 旋 转 99 度 产生 新 图 片 ， 

// 原 图 保持 不 变 ， 

wxImage image2 = image1.Rotate90(true); 
// 水 平 镜像 产生 新 图 片 . 

// 原 图 保持 不 变 ， 


wxImage image2 = image1.Mirror(true); 


颜色 消减 


如 果 你 想 对 某 个 图 像 的 颜色 进行 消减 ,你 可 以 使 用 wxQuantize 类 的 一 些 静态 范 数 ,其 中 最 有 趣 的 
函数 Quantize 的 参数 为 一 个 输入 图 片 ,一 个 输出 图 片 ,一 个 可 选 的 wxPalette 指 针 用 来 存放 经 过 消 
减 的 颜色 ,以 及 一 个 你 希望 保留 的 颜色 个 数 ,你 也 可 以 传递 一 个 unsigned char 交 量 来 获取 一 个 
8-bit 颜 色 深度 的 输出 图 像 .最 后 的 一 个 参数 style( 类 型 ) 用 来 对 返回 的 图 像 进行 一 些 更 深入 的 控 
制 ,详情 请 参考 wxWidgets 的 手册 . 


下 面 的 代码 演示 了 怎样 将 一 幅 图 片 的 颜色 消减 到 最 多 256 色 : 


#include "wx/image.h" 

#include "wx/quantize.h" 

wxImage image(wxT("image.png")); 
int maxColorCount = 256; 

int colors = image.CountColours(); 
wxPalette* palette = NULL; 

if (colors &gt; maxColorCount ) 


{ 
wxImage reducedImage; 
if (wxQuantize: :Quantize(image, reducedImage, 
& palette, maxColorCount) ) 
{ 
colors = reducedImage.CountColours(); 
image = reducedImage; 
} 
} 
一 个 wxImage 可 以 设置 一 个 wxPalette, 例 如 加 载 GIF 文件 的 时 候 . 然后 ,图 片 内 部 仍然 是 以 RGB 


的 方式 存储 数据 的 , 调 色 板 仅 代表 图 片 加 载 时 候 的 颜色 隐 射 关系 . 调 色 板 的 另外 一 个 用 途 是 某 些 
图 片 处 理 郴 数 用 它 来 将 图 片 保 存 为 低 颜 色 深 度 的 图 片 , 例 如 windows 的 BMP 图 片 处 理 过 程 将 检 
测 是 否 设置 了 wxBMP_8BPP_PALETTE 标 记 , 如 果 设 置 了 , 则 将 使 用 调 色 板 .而 如 果 设 置 了 
wxBMP_8BPP 标 记 ( 而 不 是 wxBMP_8BPP_PALETTE), 它 将 使 用 自己 的 算法 进行 颜色 消减 . 另 
外 某 些 图片 人 处理 过 程 自己 也 进行 颜色 消减 ,比如 PCX 的 处 理 过 程 ,除非 它 认 为 剩余 的 颜色 个 数 已 
经 足够 低 了 ,否则 它 将 对 图 片 的 颜色 进行 消减 . 


关于 调 色 板 更 多 的 信息 请 参考 第 5 章 的 " 调 色 板 "小 节 
直接 操作 wxlmage 的 元 数据 


你 可 以 直接 通过 GetData 画 数 访问 wxImage 的 元 数据 以 便 以 比 GeTRed, GetBlue, GetGreen 和 
SetRGB 更 快 的 方式 对 其 进行 操作 ,下 面 举 了 一 个 使 用 这 种 方法 将 一 个 图 片 转换 成 灰 度 图 片 的 
方法 : 


void wxImage::ConvertToGrayScale(wxImage& image) 


{ 
double red2Gray = 0.297; 
double green2Gray = 0.589; 
double blue2Gray = 0.114; 


int w = image.GetWidth(), h = image.GetHeight(); 
unsigned char *data = image.GetData(); 
int x,y; 
for (y = 0; y &lt; h; yt+) 
for (x = 0; x &lt; w; x++) 


{ 
long pos = (y * w+ x) * 3; 
char g = (char) (data[pos]*red2Gray + 
data[post+1]*green2Gray + 
data[pos+2]*blue2Gray); 
data[pos] = data[post+1] = data[pos+2] = g; 
} 


10.6 图 片 列 表 和 图 标 集 


有 时 候 , 使 用 一 组 图 片 是 非常 方便 的 .这 时 候 , 你 可 以 直接 在 你 的 代码 中 使 用 wxlmageList, 也 可 以 
和 wxWidgets 提 供 的 一 些 控件 一 起 使 用 wxImageList,wxNotebook,wxtreeCtrl 和 wxListCtrl 都 需 
要 wxlmageList 来 管理 它们 所 需要 使 用 的 图 标 . 你 也 可 使 用 wxlmageList 中 的 某 个 单独 的 图 片 在 
设 各 上 下 文 上 绘画 . 


创建 一 个 wxlImageList 需 要 的 参数 包括 单个 图 片 的 宽度 和 高 度 ,一 个 bool 值 来 指定 是 否 需 要 指定 
片 遮 罩 , 以 及 这 个 图 片 列表 的 初始 大 小 (主要 是 为 了 内 部 优化 代码 ), 然 后 一 个 一 个 的 增加 
wxBitmap 对 象 或 者 Wxlcon 对 象 .wxlmageList 不 能 直接 使 用 wxlmage 对 象 ,你 需要 先 将 其 转换 为 
wxBitmap 对 象 .wxlImageList::Add 函 数 返 回 一 个 整数 的 索引 用 来 代表 这 个 刚 增 加 的 图 片 ,在 Add 
函数 成 功 返 回 以 后 ,你 就 可 以 释放 原始 图 片 了 ,wxlmageList 已 经 在 内 部 创建 了 一 个 这 个 图 片 的 
N. 


下 面 是 创建 wxImageList 以 及 在 其 中 增加 图 片 的 一 些 例子 : 


// 创建 一 个 wxImageList 

wxImageList *imageList = new wxImageList(16, 16, true, 1); 
// 增加 一 个 透明 的 PNG 文 件 

wxBitmap bitmapi(wxT("image.png"), wxBITMAP_TYPE_PNG); 
imageList->Add(bitmap1); 

// 增加 一 个 透明 的 来 自 别 的 bitmap 的 图 片 

wxBitmap bitmap2(wxT("image.bmp"), wxBITMAP_TYPE_BMP); 
wxBitmap maskBitmap(wxT("mask.bmp"), wxBITMAP_TYPE_BMP) ; 
imageList->Add(bitmap2, maskBitmap); 

// 增加 一 个 指定 透明 颜色 的 透明 图 片 

wxBitmap bitmap3(wxT("image.bmp"), wxBITMAP_TYPE_BMP); 
imageList->Add(bitmap3, *wxRED); 

// 增加 一 个 图 标 

#include "folder .xpm" 

wxIcon icon(folder_xpm); 

imageList->Add(icon); 


你 可 以 直接 把 wxImageList 中 的 图 片 绘制 在 设备 上 下 文 上 ,通过 指定 
wxIMAGELIST_DRAW_TRANSPARENT 类 型 来 指示 绘制 透明 图 片 ,你 还 可 以 指定 的 类 型 包括 
wxIMAGELIST_DRAW_NORMAL, wxIMAGELIST_DRAW_SELECTED 或 者 
wxIMAGELIST_DRAW_FOCUSED, 用 来 表征 图 片 的 状态 ,如 下 所 示 : 


// 绘制 列表 中 所 有 的 图 片 

wxClientDC dc(window); 

SZ Cm tls 

for (i = 0; i &lt; imageList->GetImageCount(); i++) 


imageList->Draw(i, dc, i*16, ©, wxIMAGELIST_DRAW_NORMAL | 
wxIMAGELIST_DRAW_TRANSPARENT ) ; 


要 把 图 片 列 表 和 notebook 的 TAB 页 面 绑 定 在 一 起 ,你 需要 创建 一 个 包含 大 小 为 16x16 的 图 片 的 
列表 ,然后 调用 wxNotebook::SetlmageList 或 者 wxNotebook::AssignImageList 将 其 和 某 个 
WXNotebook 绑 定 ,这 两 个 函数 的 区 别 在 于 ,前 者 在 wxNotebook 释 放 的 时 候 不 释放 列表 ,而 后 者 在 
自己 被 释放 的 时 候 , 会 同时 释放 图 片 列 表 . 指 定 完 图 片 列表 以 后 ,你 就 可 以 给 某 个 页 面 指定 图 标 索 
引 以 便 在 页 面 标 签 上 显示 图 标 了 ,下 面 的 代码 演示 了 这 个 过 程 : 


// 创 建 一 个 wxImageList 

wxImageList *imageList = new wxImageList(16, 16, true, 1); 

// 增加 一 些 图 标 

wxBitmap bitmapi(wxT("folder.png"), wxBITMAP_TYPE_PNG); 

wxBitmap bitmap2(wxT("file.png"), wxBITMAP_TYPE_PNG); 

int folderIndex = imageList->Add(bitmap1) ; 

int fileIndex = imageList->Add(bitmap2); 

// 创建 一 个 拥有 两 个 页 面 的 notebook 

wxNotebook* notebook = new wxNotebook(parent, wxID_ANY); 
wxPanel* page1 = new wxPanel(notebook, wxID_ANY); 

wxPanel* page2 = new wxPanel(notebook, wxID_ANY); 

// 绑 定 图 片 列表 

notebook->AssignImageList(imageList); 

// Add the pages, with icons 

notebook->AddPage(page1, wxT("Folder options"), true, folderIndex); 
notebook->AddPage(page2, wxT("File options"), false, fileIndex); 


wxtreeCtrl 和 wxListCtrl 的 使 用 方法 和 上 面 介 绍 的 非常 相似 ,也 包含 类 似 的 两 种 绑 定 方法 . 


如 果 你 拥有 很 多 图 标 , 有 时 候 很 难 通过 索引 来 对 应 到 具体 的 图 标 ,你 可 能 想 编写 一 个 类 以 便 通 过 
字符 串 来 找到 某 个 图 片 索引 .下 面 演示 了 基于 这 个 目的 的 一 个 简单 的 实现 : 


#include "wx/hashmap.h" 

WxX_DECLARE_STRING_HASH_MAP(int, IconNameToIndexHashMap) ; 
// 通过 名 字 引 用 图 片 的 类 

class IconNameToIndex 


public: 
IconNameToIndex( ) 
// 在 图 片 列表 中 增加 一 个 已 经 命名 的 图 片 
void Add(wxImageList* list, const wxBitmap& bitmap, 
const wxString& name) { 
m_hashMap[name] = list->Add(bitmap); 


} 

// 在 图 片 列表 中 增加 一 个 已 命名 的 图 标 

void Add(wxImageList* list, const wxIcon& icon, 
const wxString& name) { 
m_hashMap[name] = list->Add(icon); 


} 

// 通过 名 称 找到 索引 

int Find(const wxString& name) { return m_hashMap[name]; } 
private: 

IconNameToIndexHashMap m_hashMap; 


}; 


wxlconBundle 类 同样 也 是 一 个 图 片 列表 ,不 过 这 个 类 的 目的 是 为 了 将 多 个 不 同 分 辩 率 的 图 标 保 
存在 一 个 类 中 而 不 是 多 个 类 中 ,以 便 系统 在 合适 的 时 候 根据 不 同 的 使 用 目的 选择 一 个 特定 的 图 

标 .比如 ,在 资源 管理 器 中 的 图 标 通常 比 在 主 窗口 标题 栏 上 显示 的 图 标 要 大 的 多 .下 面 的 例子 演示 
了 其 用 法 : 


// 创建 一 个 只 有 单个 16x16 图 标的 图 片 集 

#include "file16x16.xpm" 

wxIconBundle iconBundle(wxIcon(file16x16_xpm) ); 

// 在 图 片 集中 增加 一 个 32x32 的 图 片 
iconBundle.Add(wxIcon(wxT("file32x32.png"), wxBITMAP_TYPE_PNG)); 
// 从 一 个 包含 多 个 图 片 的 文件 中 创建 一 个 图 片 集 

wxIconBundle iconBundle2(wxT("multi-icons.tif"), wxBITMAP_TYPE_TIF); 
// 从 图 片 集中 获取 指定 大 小 的 图 片 , 如 果 找 不 到 则 继续 寻找 

// WXSYS_ICON_X，wxSYS_ICON_Y 大 小 的 图 片 

wxIcon icon = iconBundle.GetIcon(wxSize(16,16)); 

// 将 图 片 集 指定 给 某 个 主 窗口 

wxFrame* frame = new wxFrame(parent, wxID_ANY); 
frame->SetIcons(iconBundle) ; 


在 windows 系 统 上 ,Setlcons 函 数 期 待 一 个 包含 16x16 和 32x32 大 小 的 图 标的 图 标 集 . 


10.7 自 定义 wxWidgets 提 供 的 小 图 片 


WXArtProvider 这 个 类 人 允许 你 更 改 wxWidgets 默 认 提 供 的 那些 小 图 片 ,比如 wxWidgets HTML 帮 
助 阅读 器 中 或 者 默认 的 Log 对 话 框 中 使 用 的 图 片 . 


wxWidgets 提 供 了 一 个 标准 的 wxArtProvider 对 象 ,并 且 体系 内 的 一 些 需 要 使 用 图 标 和 小 图 片 的 
地 方 都 调用 了 这 个 类 的 wxArtProvider::GetBitmap 和 wxArtProvider::Getlcon 画 数 . 


小 图 片 是 由 两 个 标识 符 决定 的 : 主 标 识 符 (wxArtID) 和 客户 区 标识 符 (WwxArtClient). 其 中 客户 区 标 
识 符 只 在 同一 个 主 标 识 符 在 不 同 的 窗口 中 需要 不 同 的 图 片 的 时 候 才 使 用 ,比如 ,wxHTML 帮 助 窗 
口 使 用 的 图 标 使 用 下 面 的 代码 取得 的 : 


wxBitmap bmp = wxArtProvider::GetBitmap(wxART_GO_BACK,wxART_TOOLBAR); 


如 果 你 想 浏览 所 有 wxWidgets 提 供 的 小 图 片 以 及 它们 的 标识 符 ,你 可 以 编译 和 运行 wxWidgets 
自 带 的 samples/artprov 中 的 例子 , 它 的 外 观 如 下 图 所 示 : 


Art resources browser 
Client wxSAT_OTHER 


weArtlD 
(3 weART_ERROR 
2) weART_QUESTION 


HART _ WARNING 


si) wxART_INFORMATION 

t wxaRT_ADD_BDDKMARK 
> wxaRT_DEL_BDODOKMARK 
wxaRT_HELP_SIDE_PSANEL 
A wsaRT_HFILP_SFTTINGS 


Close 





要 替换 wxWidgets 提 供 的 这 些小 图 片 ,你 需要 实现 一 个 wxArtProvider 的 派生 类 , 重 载 其 中 的 
CreateBitmap 画 数 ,然后 在 Onlnit 范 数 中 调用 wxArtProvider::PushProvider 以 便 让 wxWidgets 知 
道 .下 面 的 这 个 例子 替换 了 wxHTML 帮 助 窗口 中 的 大 部 分 默认 的 图 标 : 


// 新 的 图 标 

#include "bitmaps/helpbook.xpm" 
#include "bitmaps/helppage.xpm" 
#include "bitmaps/helpback.xpm" 
#include "bitmaps/helpdown. xpm" 
#include "bitmaps/helpforward.xpm" 
#include "bitmaps/helpoptions.xpm" 
#include "bitmaps/helpsidepanel.xpm" 
#include "bitmaps/helpup. xpm" 
#include "bitmaps/helpuplevel.xpm" 
#include "bitmaps/helpicon.xpm" 
#include "wx/artprov.h" 

class MyArtProvider : public wxArtProvider 


protected: 
virtual wxBitmap CreateBitmap(const wxArtID& id, 
const wxArtClient& client, 
const wxSize& size); 


J; 

// 新 的 CreateBitmap 辑 数 

wxBitmap MyArtProvider::CreateBitmap(const wxArtID& id, 
const wxArtClient& client, 
const wxSize& size) 


if (id == wxART_HELP_SIDE_PANEL) 
return wxBitmap(helpsidepanel_xpm); 
if (id == wxART_HELP_SETTINGS) 
return wxBitmap(helpoptions_xpm); 
if (id == wxART_HELP_BOOK) 
return wxBitmap(helpbook_xpm); 
if (id == wxART_HELP_FOLDER) 
return wxBitmap(helpbook_xpm); 
if (id == wxART_HELP_PAGE) 
return wxBitmap(helppage_xpm); 
if (id == wxART_GO_BACK) 
return wxBitmap(helpback_xpm); 
if (id == wxART_GO_FORWARD) 
return wxBitmap(helpforward_xpm); 
if (id == wxART_GO_UP) 
return wxBitmap(helpup_xpm); 
if (id == wxART_GO_DOWN) 
return wxBitmap(helpdown_xpm) ; 
if (id == wxART_GO_TO_PARENT) 
return wxBitmap(helpuplevel_xpm) ; 
if (id == wxART_FRAME_ICON) 
return wxBitmap(helpicon_xpm); 
if (id == wxART_HELP) 
return wxBitmap(helpicon_xpm); 


// Any wxWidgets icons not implemented here 
// will be provided by the default art provider. 
return wxNullBitmap; 

} 

// 你 的 初始 化 函数 

bool MyApp: :OnInit() 


wxArtProvider: :PushProvider(new MyArtProvider) ; 


return true; 


第 十 草 小 结 


在 这 一 章 里 ,我 们 学 习 了 怎样 使 用 wxWidgets 中 的 图 片 相关 的 类 wxBitmap, wxlcon, wxCursor 和 
wxlmage, 还 学 习 了 怎样 使 用 wxlImageList 和 wxlconBundle, 以 及 怎样 定义 wxWidgets 默 认 使 用 
的 小 图 片 .更 多 相关 的 例子 请 参考 wxWidgets 自 带 的 samples/image, samples/listctrl 和 
samples/dragimag 目 录 中 的 例子 . 


在 下 一 章 里 ,我 们 将 介绍 一 下 怎样 使 用 剪贴 板 来 传输 数据 以 及 怎样 实现 拖 放 编程 . 
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用 程序 和 别 的 应 用 程序 进行 交互 的 一 种 最 基本 的 方式 ,大 多 数 老道 的 应 用 程序 还 会 允许 使 用 者 
在 一 个 程序 内 部 的 窗口 之 间或 者 是 不 同 的 应 用 程序 之 间 进 行 拖 放 操作 .比如 把 一 个 文件 从 资源 
管理 器 拖 放 到 应 用 程序 窗口 ,以 便 这 个 窗口 直接 填充 这 个 文件 相关 的 数据 .或 者 是 将 这 个 文件 名 
添加 到 某 个 列表 中 ,或 者 执行 别 的 什么 行为 .这 种 操作 上 比 起 通过 菜单 打开 一 个 对 话 框 来 选择 文件 
的 方式 要 快捷 的 多 ,你 的 用 户 将 会 很 喜欢 这 样 的 操作 方式 . 


剪贴 板 和 拖 放 操作 在 wxWidgets 中 共享 了 一 些 类 ,这 主要 是 因为 他 们 的 主要 任务 都 是 实现 数据 
传输 ,因此 本 章 把 这 两 个 操作 放 在 一 起 操作 .我 们 将 会 看 到 怎样 使 用 wxWidgets 提 供 的 标准 数据 
传输 控件 ,同时 也 会 学 习 到 怎样 实现 自己 的 数据 传输 控件 . 


11.1 数据 对 象 


wxDataObject 类 是 剪贴 板 操 作 和 拖 放 操 作 的 核心 ,这 个 类 的 实例 代表 了 拖 放 操作 中 鼠标 拖 搜 的 
事物 ,以 及 剪贴 板 操作 中 拷贝 和 粘贴 的 事物 . wxDataObject 是 一 块 聪明 的 数据 ,因为 它 知道 哪 种 
格式 它 可 以 支持 (通过 GetFormatCount 和 GetAllFormats), 也 知道 怎样 来 支持 它们 (通过 
GetdataHere). 如 果实 现 了 对 应 的 SetData 本 数 , 它 也 可 以 从 应 用 程序 的 外 部 接受 不 同 格式 的 数 
据 .我 们 将 在 本 章 的 后 边 对 此 进行 介绍 


标准 的 数据 格式 ,比如 wxDF_TEXT 是 用 整数 来 区 分 的 ,而 定制 的 数据 格式 则 是 通过 字符 串 来 区 
分 的 .wxDataFormat 类 支持 使 用 这 两 种 参数 的 构造 男 数 .下 表 列 出 了 标准 的 数据 格式 . 


wxDF_INVALID FES Zt, A FRA wxDataF ormatly 46 RK. 


wxDF_TEXT 文本 数据 格式 ,对 应 的 数据 类 型 为 wxTexTDataObject. 

wxDF_BITMAP 片 数 据 格式 ,对 应 的 数据 类 型 为 wxBitmapDataObject. 

wxDF METAFILE ”元 文件 数据 格式 ,对 应 的 数据 类 型 为 wxMetafileDataObject( 仅 支持 
Windows) 


wxDF_FILENAME ”文件 名 列表 数据 格式 ,对 应 的 数据 类 型 为 wxFileDataObject. 


你 也 可 以 创建 定制 的 数据 格式 ,在 这 种 情况 下 ,你 需要 给 wxDataFormat 构 造 画 数 传 递 一 个 定制 
的 字符 串 , 来 标识 你 的 定制 的 数据 类 型 ,这 个 数据 类 型 将 在 首次 使 用 的 时 候 被 登记 . 


剪贴 板 操 作 和 拖 放 操作 都 需要 人 处理 数据 源 ( 数 据 提供 者 ) 和 数据 目标 (数据 接收 者 ). 它 们 可 以 位 于 
同一 个 应 用 程序 内 ,甚至 是 位 于 同一 个 窗口 内 ,比如 ,你 在 同一 个 窗口 内 把 一 段 文本 从 一 个 位 置 拖 
到 另 一 个 位 置 ,我 们 来 分 别 描述 一 下 这 两 个 角色 . 


数据 源 的 职责 


数据 源 负 责 创建 要 包含 要 传输 的 数据 的 数据 对 象 ,在 创建 数据 对 象 以 后 ,数据 源 还 负 
SetData 函 数 将 其 传递 给 剪贴 板 , 或 者 在 拖 放 操作 开始 时 ,通过 DoDragDrop 豆 数 将 其 传递 给 一 个 
WXDropSource 对 象 . 


在 这 种 情况 下 ,剪贴 板 操作 和 抑 放 操作 的 最 大 的 不 同 在 于 剪贴 板 传输 的 数据 必须 使 用 new 画 数 ， 
在 堆 上 创建 ,而 且 只 能 被 剪贴 板 在 其 不 被 需要 的 时 候 释 放 , 事 实 上 ,我 们 根本 不 知道 它 是 在 什么 时 
候 被 释放 的 ,我 们 其 至 连 原始 的 数据 是 什么 时 候 被 放 到 剪贴 板 上 去 的 也 不 知道 .而 另 一 方面 ,用 于 
拖 放 操作 的 数据 对 象 只 需要 在 DoDragDrop 执 行 期 间 存在 ,执行 完 以 后 就 可 以 被 安全 地 释放 了 ， 
因此 ,这 种 数据 对 象 , 即 可 以 在 堆 上 创建 ,也 可 以 在 栈 上 创建 (意思 就 是 一 个 局 部 变量 ). 


另 一 个 细微 的 差别 在 于 :对 于 剪贴 板 操 作 应 用 程序 通常 很 清楚 它 正在 进行 的 操作 的 整个 过 程 . 当 
进行 了 剪 切 操作 的 时 候 , 数 据 被 首先 拷贝 到 剪 切 板 ,然后 从 当前 操作 的 对 象 中 移 除 .这 通常 是 由 于 
用 户 对 菜单 项 的 选择 来 触发 的 .但 是 对 于 拖 放 操 作 来 说 ,应 用 程序 只 有 在 DoDragDrop 画 数 执 行 

以 后 ,才能 了 解 这 些 信息 


数据 目标 的 职责 


要 从 剪贴 板 接收 数据 (意味 着 一 个 粘贴 操作 ), 你 应 该 首先 创建 一 个 支持 你 想 要 获取 的 数据 格式 
的 wxDataObject 的 派生 类 ,以 便 将 其 传递 给 wxClipboard::GetData 本 数 .如 果 这 个 函数 返回 失败 ， 
表明 剪贴 板 上 没有 你 想 要 的 类 型 的 数据 .如 果 返 回 成 功 , 则 表明 剪贴 板 上 的 数据 已 经 被 成 功 地 传 
输 到 你 创建 的 wxDataObject 的 派生 类 中 . 


对 于 拖 放 操作 , 当 一 个 数据 对 象 被 放置 的 时 候 ,wxDropTarget::OnData 虚 函数 业 会 被 调用 .如 果 
数据 类 型 合适 ,点 用 程序 可 以 调用 wxDropTarget::OnData 画 数 来 获取 相应 的 数据 . 
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要 使 用 剪贴 板 , 你 主要 是 在 调用 全 局 指针 wxTheClipboard 的 成 员 画 数 . 在 进行 拷贝 或 者 粘贴 的 

动作 之 前 ,你 必须 先 通 过 wxClipboard::Open 获 得 剪贴 板 的 控制 权 ,如 果 这 个 函数 返回 成 功 ,你 将 

已 经 获得 了 剪贴 板 的 控制 权 ,可 以 调用 wxClipboard::SetData 来 将 数据 拷贝 到 剪贴 板 上 ,或 者 调 

用 wxClipboard::GetData 函 数 从 剪贴 板 上 获取 数据 .最 后 ,你 需要 调用 wxClipboard::Close 函 数 来 
释放 剪贴 板 的 控制 权 . 一 旦 你 不 使 用 剪贴 板 了 ,就 点 该 尽快 释放 掉 剪 贴 板 的 控制 权 . 


wxClipboardLocker 类 可 以 在 其 构造 本 数 中 获得 剪贴 板 的 控制 权 ( 如 果 可 以 的 话 ), 并 且 在 其 析 构 
画 数 中 释放 剪贴 板 的 控制 权 , 因 此 ,你 可 以 使 用 下 面 这 样 的 代码 : 


wxClipboardLocker locker; 
if (!locker) 


， 报 告 错误 然后 返回 ... 
,.， 使 用 剪贴 板 ... 
下 边 的 代码 演示 了 怎样 将 文本 拷贝 到 剪贴 板 以 及 怎样 从 剪贴 板 读 取 文 本 数据 : 


// 拷贝 一 些 文本 到 剪贴 板 
if (wxTheClipboard->0pen()) 


{ 
// 数据 对 象 将 被 剪贴 板 释放 ， 
// 因此 不 在 要 你 的 应 用 程序 中 释放 它们 . 
wxTheClipboard->SetData(new wxTextDataObject(wxT("Some text"))); 
wxTheClipboard->Close(); 
} 


// 从 剪贴 板 获取 一 些 文本 
if (wxTheClipboard->0pen()) 


if (wxTheClipboard->IsSupported(wxDF_TEXT) ) 


{ 
wxTextDataObject data; 


wxTheClipboard->GetData(data) ; 
wxMessageBox(data.GetText()); 


} 
wxTheClipboard->Close(); 
} 


下 边 是 一 个 操作 图 片 的 例子 : 


// 将 一 副 图 片 拷 贝 到 剪贴 板 

wxImage image(wxT("splash.png"), wxBITMAP_TYPE_PNG); 
wxBitmap bitmap(image.ConvertToBitmap()); 

if (wxTheClipboard->0pen()) 


{ 
// RHE RAT RSS Ns RA, 
// 因此 不 在 要 你 的 应 用 程序 中 释放 它们 . 
wxTheClipboard->SetData(new wxBitmapDataObject(bitmap) ) 
wxTheClipboard->Close(); 

} 


// 从 剪贴 板 读 取 一 幅 图 片 
if (wxTheClipboard->0pen() ) 


{ 
if (wxTheClipboard->IsSupported(wxDF_BITMAP) ) 
wxBitmapDataObject data; 
wxTheClipboard->GetData( data ); 
bitmap = data.GetBitmap(); 
} 
wxTheClipboard->Close(); 
} 
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数据 的 时 候 , 允 许 或 者 禁用 相关 的 菜单 项 ,工具 条 上 的 按钮 以 及 一 些 普通 的 按钮 .这 个 工作 是 通 
wxWidgets 的 界面 更 新 机 制 来 完成 的 .在 合适 的 时 候 wxWidgets 将 会 给 你 的 应 用 程序 发 送 


过 


wxUpdateUIEvent 事 件 , 详 情 请 参考 第 九 章 "创建 自己 自 定义 的 对 话 框 ". 这 个 事件 允许 你 在 系统 


空 闪 的 时 候 根据 剪贴 板 的 数据 来 更 新 你 的 用 户 界面 . 


某 些 控件 ,比如 wxTextCtrl 已 经 实现 了 用 户 界面 的 自动 更 新 .如 果 你 的 菜单 项 或 者 工具 条 使 用 了 
标准 的 标识 符 wxID_CUT wxID_COPY 和 wxID_PASTE, 并 且 指 定 了 命令 事件 将 首先 被 活动 的 
控件 处 理 ,那么 对 应 的 控件 将 会 自动 按照 用 户 的 预期 来 进行 界面 更 新 .参考 第 二 十 章 " 优 化 你 的 应 
用 程序 "来 学 习 怎 样 通 过 重 坊 WxFrame::ProcessEvent 函 数 闻 命 合 事 件 传 北 到 当前 激活 的 控件 . 


11.3 实现 拖 放 操作 


你 可 以 在 你 的 应 用 程序 中 实现 拖 放 源 , 拖 放 目标 或 者 两 者 同时 实现 . 
实现 拖 放 源 


要 实现 一 个 拖 放 源 ,也 就 是 说 要 提供 用 户 用 于 拖 放 操作 的 数据 ,你 需要 使 用 一 个 wxDropSource 
类 的 实例 .要 注意 下 面 描述 的 事情 都 是 在 你 的 应 用 程序 已 经 认定 一 个 拖 放 操作 已 经 开始 以 后 发 
生 的 .决定 拖 放 是 否 开 始 的 逻辑 ,是 完全 需要 由 应 用 程序 自己 决定 的 ,一 些 控件 会 通过 产生 一 个 拖 
放 开 始 事件 来 通知 应 用 程序 , 在 这 种 情况 下 ,你 不 需要 自己 关心 这 一 部 分 的 逻辑 (对 这 一 部 分 的 
逻辑 的 关心 ,可 能 会 让 你 的 饮 标 事件 处 理 代码 变 得 混乱 ). 在 本 章 中 ,也 会 提供 一 个 何 时 
wxWidgets 通 知 你 拖 放 操作 开始 的 大 概 描述 . 


一 个 拖 放 源 需要 采取 的 动作 包括 下 面 几 步 : 
1 准备 工作 
首先 ,必须 先 创建 和 初始 化 一 个 将 被 拖 动 的 数据 对 象 ,如 下 所 示 : 


wxTextDataObject myData(wxT("This text will be dragged.")); 


2 开始 拖 动 要 开始 拖 动 操 作 ,最 典型 的 方式 是 响应 一 个 鼠标 单 击 事件 ,创建 一 个 wxDropSource 
对 象 ,然后 调用 它 的 wxDropSource::DoDragDrop 画 数 , 如 下 所 示 : 


wxDropSource dragSource(this); 
dragSource.SetData(myData) ; 
wxDragResult result = dragSource.DoDragDrop(wxDrag_AllowMove) ; 


FRA A 5 iz, LAE 4 DoDragDrop h RHER: 


wxDrag_CopyOnly 只 人 允许 进行 拷贝 操作 . 
wxDrag_AllowMove 允许 进行 移动 操作 . 
wxDrag_DefaultMove 默认 操作 是 移动 数据 . 


当 创 建 wxDropSource 对 象 的 时 候 , 你 还 可 以 指定 发 起 拖 动 操作 的 窗口 ,并 且 可 以 选择 拖 动 使 用 
的 光标 ,可 选 的 范围 包括 拷贝 ,移动 以 及 不 能 释放 等 .这 些 光标 在 GTK+ 上 是 图 标 , 而 在 别 的 平台 
是 光标 ,因此 你 需要 使 用 wxDROP_ICON 来 屏 敬 这 种 区 别 ,正如 我 们 很 快 就 籽 看 到 的 拖 动 文本 的 
例子 中 演示 的 那样 . 


3 拖 动 


对 DoDragDrop 画 数 的 调用 将 会 阻止 应 用 程序 进行 其 他 处 理 ,直到 用 户 释放 鼠标 按钮 (除非 你 重 
载 了 GiveFeedback 男 数 以 便 进行 其 他 的 特殊 操作 ) 当 妃 标 在 应 用 程序 的 一 个 窗口 上 移动 时 ,如 
果 这 个 窗口 可 以 识别 这 个 拖 动 操作 协议 ,对 应 的 WxDropTarget 函 数 就 会 被 调用 ,参考 接 下 来 的 小 
节 " 实 现 一 个 拖 放 目 的 " 


4 处 理 拖 放 结果 


DoDragDrop 图 数 返 回 一 个 拖 放 操作 的 结果 ,这 个 返回 值 的 类 型 为 wxDragResult, 它 的 榴 举 值 如 
下 表 所 示 : 


wxDragError 在 拖 动 操作 的 执行 过 程 中 出 现 了 错误 ， 
wxDragNone 数据 源 不 被 拖 动 目的 接受 . 

wxDragCopy 数据 已 经 被 成 功 拷贝 . 

wxDragMove 数据 已 经 被 成 功 移动 ( 仅 适用 于 Windows). 
wxDragLink 以 完全 一 个 链接 操作 . 

wxDragCancel 用 户 已 经 取消 了 拖 放 操作 . 


你 的 应 用 程序 可 以 针对 不 同 的 返回 值 进行 自己 的 操作 ,如 果 返 回 值 是 wxDragMove, 通 常 你 需要 
删除 绑 定 在 数据 源 中 的 数据 ,然后 更 新 屏幕 显示 .而 如 果 返 回 值 是 wxDragNone, 则 表示 拖 动 操作 
已 经 被 取消 了 .下 面 举例 说 明 : 


switch (result) 


case wxDragCopy: /* 数据 被 拷贝 或 者 被 链接 : 
无 需 特别 操作 */ 
case wxDragLink: 
break; 
case wxDragMove: /* 数据 被 移动 , 删除 原始 数据 */ 
DeleteMyDraggedData(); 
break; 
default: /* 操作 被 取消 或 者 数据 不 被 接受 
或 者 发 生 了 错 误 : 
不 做 任何 操作 */ 


break; 


下 面 的 例子 演示 了 怎样 实现 一 个 文本 数据 拖 放 源 .DnDWindow 包 含 一 个 m_strText 成 员 变 量 , 当 
鼠标 左 键 按 下 的 时 候 ,针对 m_strText 的 拖 放 操作 开始 , 拖 放 操作 的 结果 通过 一 个 消息 框 显 示 . 另 
外 , 拖 放 操作 将 会 在 鼠标 已 经 拖 动 了 一 小 段 距离 后 才 会 开始 ,因此 单 击 鼠 标 动作 并 不 会 导致 一 个 
拖 放 操作 . 


void DnDWindow: :OnLeftDown(wxMouseEvent& event ) 
if ( !m_strText.IsEmpty() ) 


{ 
// 开始 拖 动 操作 
wxTextDataObject textData(m_strText); 
wxDropSource source(textData, this, 
wxDROP_ICON(dnd_copy), 
wxDROP_ICON(dnd_move), 
wxDROP_ICON(dnd_none) ); 
int flags = 0; 
if ( m_moveByDefault ) 
flags |= wxDrag_DefaultMove; 
else if ( m_moveAllow ) 
flags |= wxDrag_AllowMove; 
wxDragResult result = source.DoDragDrop(flags); 
const wxChar *pc; 
switch ( result ) 
{ 
case wxDragError: pc 
case wxDragNone: pc 
case wxDragCopy: pc 
case wxDragMove: pc 
case wxDragCancel: pc 
default: pc 


wxT("Error!"); break; 
wxT("Nothing"); break; 
wxT("Copied"); break; 
wxT("Moved"); break; 
wxT("Cancelled"); break; 
wxT("Huh?") ; break; 


wxMessageBox(wxString(wxT("Drag result: ")) + pc); 


实现 一 个 拖 放 目的 


要 实现 一 个 拖 放 目的 ,也 就 是 说 要 接收 用 户 拖 动 的 数据 ,你 需要 使 用 wxWindow::SetDropTarget 
函数 ,将 某 个 窗口 和 一 个 wxDropTarget 线 定 在 一 起 ,你 需要 实现 一 个 wxDropTarget 的 派生 类 ,并 
且 重 载 它 的 所 有 纯 虚 本 数 .另外 还 需要 重 载 OnDragOver 函数 ,以 便 返 回 一 个 wxDragResult 类 型 
的 返回 码 ,以 说 明 当 思 标 指针 移 过 这 个 窗口 的 时 候 , 光 标 应 该 怎样 显示 ,并 且 重 载 OnData 郴 数 来 
实现 放置 操作 .你 还 可 以 通过 继承 wxTexTDropTarget 或 者 wxFileDropTarget, 或 者 重 载 它 们 的 
OnDropText 或 者 OnDropFiles 函 数 来 实现 一 个 拖 放 目的 . 


下 面 的 步 又 将 发 生 在 拖 放 操作 过 程 当中 的 抑 放 目的 对 象 上 . 
1 初始 化 


WXWindow::SetDropTarget 豆 数 在 窗口 创建 期 间 被 调用 ,以 便 将 其 和 一 个 拖 放 目 的 对 象 绑 定 .在 
窗口 创建 或 者 应 用 程序 的 其 他 某 个 部 分 ,通过 函数 wxDropTarget: SDD Dee td 
和 某 一 种 数据 类 型 绑 定 ,这 种 数据 类 型 将 用 来 作为 拖 放 源 和 播放 目的 进行 协商 的 依据 . 

2 拖 动 


当 饥 标 在 拖 放 目 的 上 以 拖 动 的 方式 移动 时 ,wxDropTarget::OnEnter,wxDropTarget:: 
OnDragOver 和 wxDropTarget::OnLeave 豆 数 将 在 适当 的 时 候 被 调用 ,它们 都 将 返回 一 个 对 应 
的 wxDragResult 值 .以 便 拖 放 操作 可 以 对 其 进行 合适 的 用 户 界面 反馈 


3 放置 


当 用 户 释放 鼠标 按钮 的 时 候 ,wxWidgets 通 过 调用 画 数 wxDataObject::GetAllFormats 询 问 窗口 
48 5E 89 wxDropTarget 对 象 是 否 接 受 正在 拖 动 的 数据 .如 果 数 据 类 型 是 可 接受 的 ,那么 
wxDropTarget::OnData 将 被 调用 . 拖 放 对 象 绑 定 的 wxDataObject 对 象 籽 进行 对 应 的 数据 填充 动 
VE.wxDropTarget::OnDataly BUS i E] —~wxDragResult BY BY 14 3% Ma HEH 
wxDropSource::DoDragDropEH 2X A928 El 


使 用 标准 的 拖 放 目的 对 象 


wxWidgets 提 供 了 了 标准 的 wxDropTarget 的 派生 类 ,因此 你 不 必 在 任何 时 候 都 需要 实现 自己 的 
拖 放 对 象 .你 只 需要 实现 重 载 这 些 类 的 一 个 虚 函 数 ,以 便 在 拖 放 的 时 候 得 到 提示 . 


wxTextdropTarget 对 象 可 以 接收 被 拖 动 的 文本 数据 ,你 只 需要 重 载 OnDropText 画 数 以 便 告 
wxWidgets 当 有 文本 数据 被 放置 的 时 候 做 什么 事情 就 可 以 了 .下 面 的 例子 演示 了 当 ee 
被 放置 的 时 候 , 怎 样 将 其 添加 列表 框 内 . 


// 一 个 拖 放 目 的 用 来 将 文本 填 加 到 列表 框 
class DnDText : public wxTextDropTarget 


{ 
public: 
DnDText (wxListBox *owner) { m_owner = owner; } 
virtual bool OnDropText(wxCoord x, wxCoord y, 
const wxString& text) 
{ 


m_owner ->Append(text); 
return true; 


private: 
wxListBox *m_owner; 


3; 

// 设置 拖 放 目的 对 象 

wxListBox* listBox = new wxListBox(parent, wxID_ANY); 
listBox->SetDropTarget(new DnDText(listBox)); 


下 面 的 例子 展示 了 怎样 使 用 wxFileDropTarget, 这 个 对 象 可 接收 从 资源 管理 器 里 拖 动 的 文件 对 
象 ,并 且 报 告 拖 动 文件 的 数目 以 及 它们 的 名 称 . 





// 一 个 拖 放 目 的 类 用 来 将 拖 动 的 文件 名 添加 到 列表 框 
class DnDFile : public wxFileDropTarget 


public: 
DnDFile(wxListBox *owner) { m_owner = owner; } 
virtual bool OnDropFiles(wxCoord x, wxCoord y, 
const wxArrayString& filenames) 


{ 
size_t nFiles = filenames.GetCount(); 
wxString str; 
str.Printf( wxT("%d files dropped"), (int) nFiles); 
m_owner ->Append(str); 
for ( size_t n = 0; n &lt; nFiles; n++ ) { 
m_owner ->Append(filenames[n] ); 

} 
return true; 

3} 

private: 


wxListBox *m_owner; 


}; 

// 设置 拖 放 目的 类 

wxListBox* listBox = new wxListBox(parent, wxID_ANY); 
listBox->SetDropTarget(new DnDFile(listBox)); 


创建 一 个 自 定义 的 拖 放 目 的 


现在 我 们 来 创建 一 个 自 定义 的 拖 放 目的 , 它 可 以 接受 URLs( 网 址 ). 这 一 次 我 们 需要 重 载 OnData 
和 OnDragOver 画 数 ,我 们 还 将 实现 一 个 可 以 被 重 载 的 虚 函 数 OnDropURL. 


// 一 个 自 定义 的 拖 放 目的 对 象 , 可 以 拖 放 URL 对 象 
class URLDropTarget : public wxDropTarget 


{ 

public: 
URLDropTarget() { SetDataObject(new wxURLDataObject); } 
void OnDropURL(wxCoord x, wxCoord y, const wxString& text) 


// 当然 ， 一 个 真正 的 应 用 程序 在 这 里 应 该 做 些 更 有 意义 的 事情 
wxMessageBox(text, wxT("URLDropTarget: got URL"), 
wxICON_INFORMATION | wxOK); 


} 
// URLs 不 能 被 移动 , 只 能 被 拷贝 
virtual wxDragResult OnDragOver(wxCoord x, wxCoord y, 
wxDragResult def) 
{ 


return wxDragLink; 
} 
// 这 个 画 数 调 用 了 OnDropURL 画 数 , 以 便 它 的 派生 类 可 以 更 方便 的 使 用 


virtual wxDragResult OnData(wxCoord x, wxCoord y, 
wxDragResult def) 


{ 
if ( !GetData() ) 
return wxDragNone; 
OnDropURL(x, y, ((wxURLDataObject *)m_dataObject)->GetURL()); 
return def; 
} 


}; 

// 设置 拖 放 目的 对 象 

wxListBox* listBox = new wxListBox(parent, wxID_ANY); 
listBox->SetDropTarget(new URLDropTarget) ; 


更 多 关于 wxDataObject 的 知识 


正如 我 们 已 经 看 到 的 那样 ,wxDataObject 用 来 表示 所 有 可 以 被 拖 放 . 以 及 可 以 被 剪贴 板 操作 的 数 
据 .wxDataObject 最 重要 的 特性 之 一 ,是 在 于 它 是 一 个 "聪明 "的 数据 块 ,和 普通 的 包含 一 段 内 存 组 
冲 ,或 者 一 些 文件 的 哑 数 据 不 同 . 所 谓 " 陪 明 " 指 的 是 数据 对 像 自 己 可 以 知道 它 内 部 的 数据 可 以 支 
持 什 么 数据 格式 ,以 及 怎样 将 它 的 内 部 数据 表现 为 那 种 数据 格式 . 


所 谓 支 持 的 数据 格式 ,意思 是 说 ,这 种 格式 可 以 从 一 个 数据 对 象 的 内 部 数据 或 者 将 被 设置 的 内 部 
数据 产生 .通常 情况 下 ,一 个 数据 对 象 可 以 支持 多 种 数据 格式 作为 输入 或 者 输出 .因此 ,一 个 数据 
对 象 可 以 支持 从 一 种 格式 创建 内 部 数据 ,并 将 其 转换 为 另外 一 种 数据 格式 ,反之 亦 然 . 


当 你 需要 使 用 某 种 数据 对 象 的 时 候 , 有 下 面 几 种 可 选 方案 : 


1. 使 用 一 种 内 建 的 数据 对 象 . 当 你 只 需要 支持 文本 数据 ,图 片 数 据 ,或 者 是 文件 列表 数据 的 时 
候 , 你 可 以 使 用 wxTextdataObject,wxBitmapDataObject, 或 wxFileDataObject. 

2. 使 用 wxDataObjectSimple. 从 wxDataObjectSimple 产 生 一 个 派生 类 ,是 实现 自 定义 数据 格 
式 的 最 简便 的 方法 ,不 过 ,这 种 派生 类 只 能 支持 一 种 数据 格式 ,因此 ,你 将 不 能 够 使 用 它 和 别 
的 应 用 程序 进行 交互 .不 过 ,你 可 以 用 它 在 你 的 应 用 程序 以 及 你 应 用 程序 的 不 同 拷贝 之 间 进 
行 数据 传输 . 

3. 使 用 wxCustomDataObject 的 派生 类 ( 它 是 wxDataObjectSimple 的 一 个 子 类 ) 来 实现 自 定义 
数据 对 象 . 

4. 使 用 wxDataObjectComposite. 这 是 一 个 简单 而 强大 的 解决 方案 , 它 允 许 你 支持 任意 多 种 数 
据 格 式 ( 如 果 你 和 前 面 的 方法 结合 使 用 的 话 ,可 以 实现 同时 支持 标准 数据 和 自 定 义 数据 ). 

5 直接 使 用 wxDataObject. 这 种 方案 可 以 实现 最 大 的 有 灵活 度 和 效率 ,但 也 是 最 难 的 一 种 实现 方 


案 . 


在 拖 放 操 作 和 剪贴 板 操 作 中 ,使 用 多 重 数据 格式 最 简单 的 方法 是 使 用 wxDataObjectComposite 
对 象 ,但 是 ,这 种 使 用 方法 的 效率 是 很 低 的 ,因为 每 一 个 wxDataObjectSimple 都 使 用 自己 定义 的 
格式 来 保存 所 有 的 数据 .试想 一 下 ,你 将 从 剪贴 板 上 以 你 自己 的 格式 粘贴 超过 两 百 页 的 文本 ,其 中 
包含 Word,RTF,HTML,Unicode, 和 普通 文本 ,虽然 现在 计算 机 的 能 力 已 经 足 可 以 应 付 这 样 的 任 
务 ,但 是 从 性 能 方面 考虑 , 你 最 好 还 是 直接 从 wxDataObject 实 现 一 个 派生 类 ,用 它 来 定义 你 的 数 
据 格 式 ,然后 在 程序 中 指定 这 种 类 型 的 数据 . 


剪贴 板 操 作 和 拖 放 操作 ,潜在 的 数据 传输 机 制 将 在 某 个 应 用 程序 真正 请 求 数据 的 时 候 , 才 会 进行 
数据 拷贝 .因此 ,尽管 用 户 可 能 认为 在 自己 点 击 了 应 用 程序 的 拷贝 按钮 以 后 数据 就 已 存在 于 剪贴 
板 了 ,但 实际 上 这 时 候 仅 仅 是 告诉 剪贴 板 有 数据 存在 了 . 


实现 wxDataObject 的 派生 类 


我 们 来 看 一 下 实现 一 个 新 的 wxDataObject 的 派生 类 要 用 到 哪些 东西 .至 于 怎样 实现 的 过 程 ,我 们 
前 面 已 经 介绍 过 了 , 它 是 非常 简单 的 .因此 ,我 们 在 这 里 不 多 说 了 . 


每 一 个 wxDataObject 的 派生 类 ,都 必须 重 坊 和 实现 它 的 纯 虚 成 员 函 数 ,那些 只 能 用 来 输出 数据 或 
者 保存 数据 (意味 着 只 能 进行 单 向 操作 ) 的 数据 对 象 的 GetFormatCount 函 数 在 其 不 支持 的 方向 
上 应 该 总 是 返回 需 . 


GetAlIFormats 画 数 的 参考 为 一 个 wxDataFormat 类 型 的 列表 ,以 及 一 个 方向 (获取 或 设置 ). 它 将 
所 有 自己 在 这 个 方向 上 支持 的 数据 格式 填 和 人 这 个 列表 .GetFormatCount 函 数 则 用 来 检测 列表 中 
元 素 的 个 数 . 


GetdataHere 画 数 的 参数 是 一 个 wxDataFormat 参 数 , 以 及 一 个 void* 缓 冲 区 .如 果 操 作成 功 ,返回 
TRue, 否 则 返回 false. 这 个 画 数 必须 闻 数 据 以 给 定 的 格式 填 入 这 个 缓冲 区 ,数据 可 以 是 任意 的 二 
进 制 数据 ,或 者 是 文本 数据 ,只 要 SetData 函 数 可 以 识别 就 行 了 . 


GetdataSize 辑 数 则 返回 在 某 种 给 定 的 数据 格式 下 数据 的 大 小 . 

GetFormatCount 加 数 返回 用 于 转换 或 者 设置 的 当前 支持 数据 类 型 的 个 数 . 
GetPreferredFormat 范 数 则 返回 某 个 指定 方向 上 优选 的 数据 类 型 . 
SetData 函 数 的 参考 包括 一 个 数据 类 型 ,一 个 整数 格式 的 缓冲 区 大 小 ,以 及 一 个 void* 类 型 的 缓冲 
区 指针 .你 可 以 在 适当 的 时 候 (比如 将 其 拷贝 到 自己 的 内 部 结构 的 时 候 ) 对 其 进行 适当 的 解释 .这 
个 函数 在 成 功 的 时 候 返 回 TRue, 失 败 的 时 候 返 回 false. 

wxWidgets 的 拖 放 操作 例子 

我 们 通过 使 用 位 于 samples/dnd 目 录 的 wxWidgets 的 拖 放 操作 的 例子 ,来 演示 一 下 怎样 制作 一 个 
自 定义 的 拥有 自 定义 数据 类 型 的 数据 对 象 . 这 个 例子 演示 了 一 个 简单 的 绘图 软件 ,可 以 用 来 绘制 
和 矩形 ,三 角形 ,或 者 顶 圆 形 ,并 且 允 许 你 对 其 进行 编辑 , 拖 放 到 一 个 新 的 位 置 ,拷贝 到 剪贴 板 以 及 从 


新 粘贴 到 应 用 程序 等 操作 .你 可 以 通过 选择 文件 菜单 中 的 新 建 命令 来 创建 一 个 应 用 程序 的 主 窗 
口 .这 个 窗口 的 外 观 如 下 图 所 示 : 


E Shape Frame DEOR 
Siem Clipboard 

New default shape Ctrl-5 

Edit shape Ctrl-E 


Clear shape Ctrl-L 





这 些 图 形 是 用 继承 字 DnDShape 的 类 来 建 模 的 ,数据 对 象 被 称 为 DnDShapeDataObject. 在 学 习 
怎样 实现 这 个 数据 对 象 之 前 ,我 们 先 看 一 下 应 用 程序 是 怎样 使 用 它们 的 . 


当 一 个 剪贴 板 拷 贝 操 作 被 请 求 的 时 候 , 一 个 DnDShapeDataObject 对 象 将 被 增加 到 剪贴 板 ,这 个 
对 象 包 含 当前 正在 操作 的 图 形 的 拷贝 ,如 果 剪 贴 板 上 已 经 有 了 一 个 对 象 ,那么 旧 的 对 象 将 被 释放 . 
代码 如 下 所 示 : 


void DnDShapeFrame: :OnCopyShape(wxCommandEvent& event) 
if ( m_shape ) 
{ 


wxClipboardLocker clipLocker; 

if ( !clipLocker ) 

{ 
wxLogError(wxT("Can't open the clipboard") ); 
return; 


} 
wxTheClipboard->AddData(new DnDShapeDataObject(m_shape) ); 


剪贴 板 的 粘贴 操作 也 很 容易 理解 ,调用 wxClipboard::GetData 函 数 来 获取 位 于 剪贴 板 的 图 形 数 
据 对 象 ,然后 从 其 中 获取 图 形 数据 .前 面 我 们 已 经 介绍 过 怎样 在 剪贴 板 拥 有 对 应 数据 的 时 候 允 许 
paste 菜 单 .shapeFormatld 是 一 个 全 局 变量 ,其 中 包含 了 自 定义 的 数据 格式 名 称 :wxShape. 


void DnDShapeFrame: :OnPasteShape(wxCommandEvent& event) 


{ 
wxClipboardLocker clipLocker; 
if ( !clipLocker ) 
{ 
wxLogError(wxT("Can't open the clipboard")); 
return; 


DnDShapeDataObject shapeDataObject(NULL); 
if ( wxTheClipboard->GetData(shapeDataObject) ) 


SetShape(shapeDataObject.GetShape()); 
} 
else 


{ 
} 


void DnDShapeFrame: :OnUpdateUIPaste(wxUpdateUIEvent& event) 


wxLogStatus(wxT("No shape on the clipboard") ); 


event.Enable( wxTheClipboard-> 
IsSupported(wxDataFormat(shapeFormatiId)) ); 


为 了 实现 拖 放 操 作 , 还 需要 一 个 拖 放 目 标 对 象 ,以 便 在 图 片 数据 被 放置 的 时 候 通 知 应 用 程 

序 .DnDShapeDropTarget 类 包含 一 个 DnDShapeDataObject 数 据 对 象 ,用 来 扮演 这 个 角色 , 当 它 
的 OnData 函 数 被 调用 的 时 候 , 则 表明 正在 放置 一 个 图 形 数据 对 象 ,下 面 的 代码 演示 了 
DnDShapeDropTarget 的 声明 及 实现 : 


class DnDShapeDropTarget : public wxDropTarget 
public: 
DnDShapeDropTarget(DnDShapeFrame *frame) 
: wxDropTarget(new DnDShapeDataObject ) 
{ 


m_frame = frame; 


// 重 载 基 类 的 ( 纯 ) 虚 函数 


virtual wxDragResult OnEnter(wxCoord x, wxCoord y, wxDragResult def) 


{ 
m_frame->SetStatusText(_T("Mouse entered the frame")); 
return OnDragOver(x, y, def); 
} 
virtual void OnLeave() 
{ 
m_frame->SetStatusText(_T("Mouse left the frame")); 
} 
virtual wxDragResult OnData(wxCoord x, wxCoord y, wxDragResult def) 
{ 
if ( !GetData() ) 
{ 
wxLogError(wxT("Failed to get drag and drop data")); 
return wxDragNone; 
} 
// 通知 主 窗口 正在 进行 放置 
m_frame->OnDrop(x, y, 
((DnDShapeDataObject *)GetDataObject())->GetShape()); 
return def; 
} 
private: 


DnDShapeFrame *m_frame; 


}; 


在 应 用 程序 初始 化 图 数 里 , 主 窗口 被 创建 的 时 候 设置 这 个 拖 放 目 标 : 


DnDShapeFrame: :DnDShapeFrame(wxFrame *parent) 
: wxFrame(parent, wxID_ANY, _T("Shape Frame") ) 
{ 


SetDropTarget(new DnDShapeDropTarget(this) ); 
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作 .DndShapeFrame::OnDrag 函 数 如 下 所 示 : 


void DnDShapeFrame: :OnDrag(wxMouseEvent& event) 


if ( !m_shape ) 

{ 
event.Skip(); 
return; 


} 

// 开始 拖 放 操作 

DnDShapeDataObject shapeData(m_shape); 
wxDropSource source(shapeData, this); 
const wxChar *pc = NULL; 

switch ( source.DoDragDrop(true) ) 


{ 
default: 
case wxDragError: 
wxLogError(wxT("An error occured during drag and drop")); 
break; 
case wxDragNone: 
SetStatusText(_T("Nothing happened") ); 
break; 
case wxDragCopy: 
pc = _T("copied"); 
break; 
case wxDragMove: 
pc = _T("moved"); 
if ( ms_lastDropTarget != this ) 
// 如 果 这 个 图 形 被 放置 在 自己 的 窗口 上 
// 不 要 删除 它 
SetShape(NULL); 
} 
break; 
case wxDragCancel: 
SetStatusText(_T("Drag and drop operation cancelled")); 
break; 
i 
if ( pc ) 


SetStatusText(wxString(_T("Shape successfully ")) + pc); 


} 
// 在 其 他 情况 下 , 状态 文本 已 经 被 设置 了 


当 用 户 释 放 锯 标 以 表明 正在 执行 放置 操作 的 时 候 ,wxWidgets 调 用 
DnDShapeDropTarget::OnData 辑 数 ,这 个 男 数 将 以 一 个 新 的 DndShape 对 象 来 调用 
DndShapeFrame::OnDrop 画 数 , 以 便 给 DndShape 对 象 设置 一 个 新 的 位 置 . 这 样 , 拖 放 操作 就 完 
成 了 . 


void DnDShapeFrame: :OnDrop(wxCoord x, wxCoord y, DnDShape *shape) 
{ 

ms_lastDropTarget = this; 

wxPoint pt(x, y); 

wxString s; 

s.Printf(wxT("Shape dropped at (%d, %d)"), pt.x, pt.y); 

SetStatusText(s); 

shape->Move(pt); 

SetShape(shape); 


现在 ,唯一 剩 下 的 事情 ,就 是 实现 自 定义 的 wxDataObject 对 象 了 .为 了 说 明 得 更 清楚 ,我 们 将 对 整 
个 实现 进行 逐 项 说 明 .首先 ,我 们 来 看 一 下 自 定 义 数 据 类 型 标识 符 声 明 , 以 及 
DndShapeDataObject 类 的 声明 , 它 的 构造 本 数 和 析 构 函数 ,和 它 的 数据 成 员 . 


数据 类 型 标识 符 是 shapeFormatld, 它 是 一 个 全 局 变量 ,在 整个 例子 中 都 有 使 用 .构造 本 数 通过 
GeTDataHere 函 数 获得 当前 图 形 (如 果 有 的 话 ) 的 一 个 拷贝 作为 参数 .这 个 拷贝 也 可 以 通过 
DndShape::Clone 画 数 产生 .DnDShapeDataObject 的 析 构 函数 将 会 释放 这 个 拷贝 . 


DndShapeDataObject 可 以 提供 位 图 和 (在 支持 的 平台 上 ) 源 文件 来 表示 它 的 内 部 数据 .因此 , 它 
还 拥有 wxBitmapDataObject 和 wxMetaFileDataObject 两 个 类 型 的 数据 成 员 ( 以 及 一 个 标记 用 
来 指示 当前 正在 使 用 哪 种 类 型 ) 来 缓存 内 部 数据 以 便 在 需要 的 时 候 提 供 这 种 格式 . 


// 自 定义 的 数据 格式 标识 符 


static const wxChar *shapeFormatId = wxT("wxShape"); 
class DnDShapeDataObject : public wxDataObject 


public: 
// WERB 8 Bie N jat 
// 这 样 在 原来 的 图 形 对 象 被 释放 以 后 , 这 里 的 图 形 对 象 是 有 效 的 
DnDShapeDataObject(DnDShape *shape = (DnDShape *)NULL) 


{ 
if ( shape ) 
// 我 们 需要 拷贝 真正 的 图 形 对 象 , 而 不 是 只 拷贝 指针 
// 这 是 因为 图 形 对 象 有 可 能 在 任何 时 候 被 删除 , 在 这 种 情况 下 
// 剪贴 板 上 的 数据 仍然 应 该 是 有 效 的 
// 因此 我 们 使 用 下 边 的 方法 来 实现 图 形 拷贝 
void *buf = malloc(shape->DnDShape: :GetDataSize()); 
shape->GetDataHere(buf ); 
m_shape = DnDShape: :New(buf); 
free(buf); 
} 
else 
// 不 需要 拷贝 任何 东西 
m_shape = NULL; 
} 
// 这 个 字符 串 应 该 用 来 唯一 标识 我 们 的 数据 格式 类 型 
// 除 此 以 外 , 它 可 以 是 任意 的 字符 串 
m_formatShape.SetId(shapeFormatId); 
// 我 们 直到 需要 的 (也 就 是 数据 被 第 一 次 请 求 ) 时 候 才 产生 图 片 或 者 元 文件 数据 
m_hasBitmap = false; 
m_hasMetaFile = false; 
} 


virtual ~DnDShapeDataObject() { delete m_shape; } 
// 在 这 个 画 数 被 调用 以 后 , 图 形 数 据 六 调用 者 所 有 

// 调用 者 将 负责 释放 相关 内 存 

DnDShape *GetShape() 


DnDShape *shape = m_shape; 
m_shape = (DnDShape *)NULL; 
m_hasBitmap = false; 
m_hasMetaFile = false; 
return shape; 


} 
// 其 他 成 员 画 数 省 略 


// 数据 成 员 

private: 
wxDataFormat m_formatShape; // 我 们 的 自 定 义 格式 
wxBitmapDataObject m_dobjBitmap; // 用 来 响应 位 图 格式 请 求 
bool m_hasBitmap; // 如 果 m_dobjBitmap 有 效 为 真 
wxMetaFileDataObject m_dobjMetaFile;// 用 来 响应 元 数据 格式 请 求 
bool m_hasMetaFile;// 如 果 m_dobjMetaFile 有 效 为 真 
DnDShape *m_shape; // 原始 数据 


接 下 来 我 们 来 看 一 下 那些 用 于 回答 和 我 们 内 部 存储 的 数据 相关 的 问题 的 函 

数 .GetPreferredFormat 只 简单 的 返回 m_formatShape 数 据 绑 定 的 本 地 的 数据 格式 , 它 是 在 我 们 
的 构造 画 数 中 使 用 wxShape 类 型 初始 化 的 .GetFormatCount 画 数 用 来 检测 某 种 特定 的 格式 是 否 
可 以 被 用 来 获取 或 者 设置 数据 .在 获取 数据 的 时 候 , 只 有 位 图 和 元 文件 格式 是 可 以 被 处 理 

的 .GetDataSize 函 数 依据 请 求 的 数据 格式 的 不 同 返 回合 适 的 数据 大 小 ,如 果 必 要 的 话 , 为 了 得 到 
这 个 大 小 ,你 可 以 在 这 个 时 候 创 建 位 图 成 员 或 者 元 文件 成 员 . 


virtual wxDataFormat GetPreferredFormat(Direction dir) const 
return m_formatShape; 


virtual size_t GetFormatCount(Direction dir) const 
{ 

// 我 们 自 定义 的 数据 格式 类 型 即 可 以 支持 GetData() 

// 也 可 以 支持 SetData() 

size_t nFormats = 1; 

if ( dir == Get ) 


// 但 是 , 位 图 格式 只 支持 输出 
nFormats += m_dobjBitmap.GetFormatCount(dir); 
nFormats += m_dobjMetaFile.GetFormatCount (dir); 
} 
return nFormats; 
} 
virtual void GetAllFormats(wxDataFormat *formats, Direction dir) const 
{ 
formats[0] = m_formatShape; 
if ( dir == Get ) 


{ 
// 在 获取 方向 上 我 们 增加 位 图 和 元 文件 两 种 格式 的 支持 
// 在 Windows 平 台 
m_dobjBitmap.GetAllFormats(&formats[1], dir); 
// 不 要 认为 m_dobjBitmap 只 有 一 种 格式 
m_dobjMetaFile.GetAllFormats(&formats[1 + 
m_dobjBitmap.GetFormatCount(dir)], dir); 
} 
virtual size_t GetDataSize(const wxDataFormat& format) const 
if ( format == m_formatShape ) 
{ 


return m_shape->GetDataSize(); 
else if ( m_dobjMetaFile.IsSupported(format) ) 
if ( !m_hasMetaFile ) 


CreateMetaFile(); 
return m_dobjMetaFile.GetDataSize(format); 


} 
else 

wxASSERT_MSG( m_dobjBitmap.IsSupported(format), 

wxT("unexpected format") ); 
if ( !m_hasBitmap ) 
CreateBitmap(); 

return m_dobjBitmap.GetDataSize(); 

} 


GetdataHere 函 数 按照 请 求 的 数据 格式 类 型 将 数据 拷贝 到 void* 类 型 的 缓冲 区 : 


virtual bool GetDataHere(const wxDataFormat& format, void *pBuf) const 


{ 


if ( format == m_formatShape ) 


// 使 用 ShapeDump 结 构 将 其 转换 为 void* 流 
m_shape->GetDataHere(pBuf); 
return true; 


else if ( m_dobjMetaFile.IsSupported(format) ) 
if ( !m_hasMetaFile ) 


CreateMetaFile(); 
return m_dobjMetaFile.GetDataHere(format, pBuf); 


} 
else 

wxASSERT_MSG( m_dobjBitmap.IsSupported(format), 

wxT("unexpected format") ); 
if ( !m_hasBitmap ) 
CreateBitmap(); 

return m_dobjBitmap.GetDataHere(pBuf ); 

} 


SetData 函 数 只 需要 人 处理 本 地 格式 ,因此 , 它 需 要 做 的 所 有 事情 就 是 使 用 DndShape::New 画 数 来 
制作 一 个 参数 图 形 的 拷贝 : 


virtual bool SetData(const wxDataFormat& format, 
size_t len, const void *buf) 
{ 


wxCHECK_MSG( format == m_formatShape, false, 
wxT( "unsupported format") ); 

delete m_shape; 

m_shape = DnDShape: :New(buf); 

// the shape has changed 

m_hasBitmap = false; 

m_hasMetaFile = false; 

return true; 


实现 DndShape 和 void* 类 型 的 互相 转换 的 方法 是 非常 直接 的 . 它 使 用 了 一 个 ShapeDump 的 结构 
来 保存 图 形 的 详细 信息 .下 面 是 其 实现 方法 : 


// 静态 函数 用 来 从 一 个 void* 缓 冲 区 中 创建 一 个 图 形 

DnDShape *DnDShape: :New(const void *buf) 

{ 
const ShapeDump& dump = *(const ShapeDump *)buf; 
switch ( dump.k ) 


{ 
case Triangle: 
return new DnDTriangularShape( 
wxPoint(dump.x, dump.y), 
wxSize(dump.w, dump.h), 
wxColour(dump.r, dump.g, dump.b)); 
case Rectangle: 
return new DnDRectangularShape( 
wxPoint(dump.x, dump.y), 
wxSize(dump.w, dump.h), 
wxColour(dump.r, dump.g, dump.b)); 
case Ellipse: 
return new DnDE1llipticShape( 
wxPoint(dump.x, dump.y), 
wxSize(dump.w, dump.h), 
wxColour(dump.r, dump.g, dump.b)); 
default: 
wxFAIL_MSG(wxT("invalid shape!")); 
return NULL; 
} 


} 
// 返回 内 部 数据 大 小 
size_t DndShape::GetDataSize() const 


{ 


return sizeof(ShapeDump) ; 


} 
// 将 自己 填 入 一 个 void* 缓 冲 区 
void DndShape::GetDataHere(void *buf) const 


{ 
ShapeDump& dump = *(ShapeDump *)buf; 
dump.x = m_pos.x; 
dump.y = m_pos.y; 
dump.w = m_size.x; 
dump.h = m_size.y; 
dump.r = m_col.Red(); 
dump.g = m_col.Green(); 
dump.b = m_col.Blue(); 
dump.k = GetKind(); 

} 


最 后 ,我 们 回 到 DnDShapeDataObject 数 据 对 象 ,下 边 的 这 些 画 数 用 来 在 需要 的 时 候 将 内 部 数据 
转换 为 位 图 或 者 元 数据 : 


void DnDShapeDataObject::CreateMetaFile() const 

{ 
wxPoint pos m_shape->GetPosition(); 
wxSize size m_shape->GetSize(); 
wxMetaFileDC dcMF(wxEmptyString, pos.x + size.x, pos.y + size.y); 
m_shape->Draw(dcMF) ; 
wxMetafile *mf = dcMF.Close(); 
DnDShapeDataObject *self = (DnDShapeDataObject *)this; 
self->m_dobjMetaFile.SetMetafile(*mf); 
self->m_hasMetaFile = true; 
delete mf; 


void DnDShapeDataObject::CreateBitmap() const 

{ 
wxPoint pos = m_shape->GetPosition(); 
wxSize size = m_shape->GetSize(); 
int x = pos.x + size.x, 

y = pos.y + size.y; 

wxBitmap bitmap(x, y); 
wxMemoryDC dc; 
dc.SelectObject(bitmap); 
dc.SetBrush(wxBrush(wxT("white"), wxSOLID)); 
dc.Clear(); 
m_shape->Draw(dc); 
dc.SelectObject (wxNullBitmap) ; 
DnDShapeDataObject *self = (DnDShapeDataObject *)this; 
self->m_dobjBitmap.SetBitmap(bitmap) ; 
self->m_hasBitmap = true; 


我 们 自 定 义 的 数据 对 象 的 实现 到 此 为 止 就 全 部 完成 了 ,部 分 细节 (比如 图 形 怎样 把 自己 绘制 到 用 
户 界面 上 ) 没 有 在 此 列 出 ,你 可 以 参考 wxWidgets 自 带 的 samples/dnd 中 的 代码 . 


wxWidgets 中 的 拖 放 相关 的 一 些 帮 助 
下 面 我 们 来 描述 一 些 在 实现 拖 放 操作 时 可 以 给 你 帮助 的 控件 . 
wxTreeCtrl 


你 可 以 使 用 EVT_TREE_BEGIN_DRAG 或 EVT_TREE_BEGIN_RDRAG 事 件 映射 宏 来 增加 对 
鼠标 左 键 或 右键 开始 的 拖 放 操作 的 处 理 ,这 是 这 个 控件 内 部 的 鼠标 事件 义理 函数 实现 的 .在 你 的 
事件 义理 函数 中 ,你 可 调用 wxtreeEvent::Allow 来 允许 wxtreeCtnl 使 用 它 自 己 的 拖 放 实现 来 发 送 
一 个 EVT_TREE_END_DRAG 事 件 .如 果 你 选择 了 使 用 tree 控 件 自己 的 拖 放 代码 ,那么 随 着 拖 放 
鼠标 指针 的 移动 ,将 会 有 一 个 小 的 拖 动 图 片 被 创建 ,并 随 之 移动 ,整个 放置 的 操作 则 完全 需要 在 应 
用 程序 的 结束 放置 事件 处 理 范 数 中 实现 . 


下 面 的 例子 演示 了 怎样 使 用 树 状 控件 提供 的 拖 放 事件 ,来 实现 当 用 户 把 树 状 控件 中 的 一 个 子 项 
拖 到 另外 一 个 子 项 上 的 时 候 , 产 生 一 个 被 拖 动 子 项 的 拷贝 . 


BEGIN_EVENT_TABLE(MyTreeCtrl, wxTreeCtr1) 
EVT_TREE_BEGIN_DRAG(TreeTest_Ctrl1, MyTreeCtr1: :OnBeginDrag) 
EVT_TREE_END_DRAG(TreeTest_Ctr1, MyTreeCtrl::OnEndDrag) 

END_EVENT_TABLE( ) 

void MyTreeCtrl: :OnBeginDrag(wxTreeEvent& event) 


// 需要 显 式 的 指明 人 允许 拖 动 
if ( event.GetItem() != GetRootItem() ) 


{ 
m_draggediItem = event.GetItem(); 


wxLogMessage(wxT("OnBeginDrag: started dragging %s"), 
GetItemText(m_draggedItem).c_str()); 
event .Allow(); 
} 


else 


wxLogMessage(wxT("OnBeginDrag: this item can't be dragged.")); 


} 


} 
void MyTreeCtrl: :OnEndDrag(wxTreeEvent& event) 
{ 


wxTreeItemId itemSrc = m_draggedItem, 
itemDst = event.GetItem(); 
m_draggedItem = (wxTreeItemId)0l; 
// 在 哪里 拷贝 这 个 子 项 呢 ? 
if ( itemDst.IsOk() && !ItemHasChildren(itemDst) ) 


// 这 种 情况 下 拷贝 到 它 的 父 项 内 
itemDst = GetItemParent(itemDst); 


} 
if ( !itemDst.IsOk() ) 


wxLogMessage(wxT("OnEndDrag: can't drop here.")); 
return; 


} 


wxString text = GetItemText(itemSrc); 

wxLogMessage(wxT("OnEndDrag: '%s' copied to '%s'."), 
text.c_str(), GetItemText(itemDst).c_str()); 

// ”增加 新 的 子 项 

int image = wxGetApp().ShowImages() ? TreeCtrlIcon_File : -1; 

AppendiItem(itemDst, text, image); 


如 果 你 想 自己 处 理 拖 放 操作 ,比如 使 用 wxDropSource 来 实现 ,你 可 以 在 拖 放 开始 事件 处 理 函 数 
中 使 用 wxtreeEvent:: Allow 画 数 来 禁止 默认 的 拖 放 动作 ,并 且 开 始 你 自己 的 拖 放 动作 .这 种 情况 
下 拖 放 结束 事件 将 不 会 被 发 送 ,因为 你 已 经 决定 用 自己 的 方式 来 处 理 拖 放 (如 果 使 用 
wxDropSource::DoDragDrop 画 数 ,你 需要 自己 检测 何 时 拖 放 结束 ). 


wxListCtrl 


这 个 类 没有 提供 默认 的 拖 动 图 片 ,或 者 拖 放 结 束 事件 ,但 是 , 它 可 以 让 你 知道 什么 时 候 开 始 一 个 拖 
放 操 作 . 使 用 EVT_LIST_BEGIN_DRAG 或 EVT_LIST_BEGIN_RDRAG 事 件 映 射 宏 来 实现 你 自 
己 的 拖 放 代 码 .你 也 可 以 使 用 EVT_LIST_COL_BEGIN_DRAG,EVT_LIST_COL_DRAGGING 

和 EVT_LIST_COL_END_DRAG 来 检测 何 时 某 一 个 单独 的 列 正在 被 拖 动 . 


wxDraglmage 


在 你 实现 自己 的 抑 放 操作 的 时 候 , 可 以 很 方便 地 使 用 wxDraglmage 类 . 它 可 以 在 顶层 窗口 上 绘制 
一 副 图 片 , 还 可 以 移动 这 个 图 片 ,并 且 不 损坏 它 后 面 的 窗口 .这 通常 是 通过 在 移动 之 前 保存 一 份 背 
景 窗口 ,并 且 在 需要 的 时 候 , 重 绘 背 景 窗口 来 实现 的 . 


下 图 演示 了 wxDraglmage 例 子 中 的 主 窗口 ,你 可 以 在 wxWidgets 的 samples/dragimag 中 找到 这 
个 例子 .当主 窗口 上 的 三 个 拼图 块 被 拖 动 时 ,将 会 采用 不 同 的 拖 动 图 片 ,分 别 为 图 片 本 身 , 一 -1 
标 ,或 者 一 个 动态 产生 的 包含 一 串 文本 的 图 片 .如 果 你 选择 使 用 整个 屏幕 这 个 选项 ,那么 这 个 图 片 
可 以 被 拖 动 到 窗口 以 外 的 地 方 ,在 Windows 平 台 上 ,这 个 例子 即 可 以 使 用 标准 的 wxDraglmage 的 
实现 (默认 情形 ) 来 编译 ,也 可 以 使 用 本 地 原生 控件 来 编译 ,后 者 需要 你 在 dragimag.cpp 中 将 
wxUSE_GENERIC_DRAGIMAGEE #1. 


i wxDragimage sample 


Use whole screen for dragging 
Exit 





当 检 测 到 开始 拖 动 操作 的 时 候 , 创 建 一 个 wxDraglmage 对 象 ,并 且 把 它 存 放 在 任何 你 可 以 在 整个 
拖 动 过 程 中 访问 的 地 方 ,然后 调用 BeginDrag 来 开始 拖 动 ,调用 EndDrag 来 结束 拖 动 .要 移动 这 个 
片 ,第 一 次 要 使 用 Show 函 数 ,后 面 则 需要 使 用 Move 函 数 .如 果 你 需要 在 拖 动 过 程 当中 刷新 屏幕 
内 容 (比如 在 dragimag 的 例子 中 高 量 显示 某 个 项 目 ), 你 需要 先 调用 Hide 画 数 ,然后 更 新 你 的 窗口 ， 
9% IS iA FA Move BX 3X, A Is MA Showke KX. 


你 可 以 在 一 个 窗口 内 拖 动 ,也 可 以 在 整个 屏幕 或 者 屏幕 的 任何 一 部 分 内 拖 动 ,以 节省 资源 .如 果 你 
希望 用 户 可 以 在 两 个 拥有 不 同 的 顶层 父 窗口 的 窗口 之 间 拖 动 ,你 就 必须 使 用 全 屏 拖 动 的 方式 .全 


动 则 不 会 进行 相应 的 更 新 .如 果 在 你 的 拖 动 过 程 当中 , 别 的 应 用 程序 对 屏幕 内 容 进行 了 改动 ,将 会 
影响 到 拖 动 的 效果 . 


在 接 下 来 的 例子 中 ,基于 上 面 的 那个 例子 ,MyCanvas 窗 口 显示 了 很 多 DragShap 类 的 图 片 ,它们 
中 的 每 一 个 都 和 一 副 图 片 绑 定 . 当 针 对 某 个 DragShap 的 拖 动 操作 开始 时 ,一 个 使 用 其 绑 定 的 图 
片 的 wxDraglmage 对 象 被 创建 ,并 且 BeginDrag 被 调用 . 当 检 测 到 鼠标 移动 的 时 候 , 调 用 
wxDraglmage::Move 画 数 来 移动 来 将 这 个 对 象 进行 相应 的 移动 .最 后 , 当 鼠 标 左 键 被 释放 的 时 
候 ,用 于 指示 拖 动 的 图 片 被 释放 ,被 拖 动 的 图 片 则 在 其 新 的 位 置 被 重 绘 . 


void MyCanvas: :OnMouseEvent (wxMouseEvent& event) 
if (event.LeftDown() ) 


DragShape* shape = FindShape(event.GetPosition()); 
if (shape) 


// 我 们 姑且 认为 拖 动 操作 已 经 开始 
// 不 过 最 好 等 待 鼠 标 移动 一 段 时 间 再 真正 开始 , 


m_dragMode = TEST_DRAG_START; 
m_dragStartPos = event.GetPosition(); 
m_draggedShape shape; 


} 


else if (event.LeftUp() && m_dragMode != TEST_DRAG_NONE) 
{ 
// 拖 动 操作 结 
m_dragMode = TEST_DRAG_NONE; 
if (!m_draggedShape || !m_dragImage) 
return; 
m_draggedShape->SetPosition(m_draggedShape->GetPosition( ) 
+ event.GetPosition() - m_dragStartPos); 
m_dragImage->Hide(); 
m_dragImage->EndDrag(); 
delete m_dragImage; 
m_dragImage = NULL; 
m_draggedShape->SetShow(true); 
m_draggedShape->Draw(dc); 
m_draggedShape = NULL; 


else if (event.Dragging() && m_dragMode != TEST_DRAG_NONE) 
{ 
if (m_dragMode == TEST_DRAG_START) 
{ 
// 我 们 将 在 鼠标 已 经 移动 了 一 小 段 距离 以 后 开始 真正 的 拖 动 
int tolerance = 2; 
int dx = abs(event.GetPosition().x - m_dragStartPos.x); 
int dy = abs(event.GetPosition().y - m_dragStartPos.y); 
if (dx &lt;= tolerance && dy &lt;= tolerance) 
return; 
// 开始 拖 动 . 
m_dragMode = TEST_DRAG_DRAGGING; 
if (m_dragImage) 
delete m_dragImage; 
// 从 画布 上 清除 拖 动 图 片 
m_draggedShape->SetShow( false) ; 
wxClientDC dc(this); 
EraseShape(m_draggedShape, dc); 
DrawShapes(dc); 
m_dragImage = new wxDragImage( 
m_draggedShape->GetBitmap()); 
// 被 拖 动 图 片 的 左上 角 到 目前 位 置 的 偏 移 量 
wxPoint beginDragHotSpot = m_dragStartPos 
m_draggedShape->GetPosition(); 
// 总 认为 坐标 系 为 被 捕获 窗口 的 客户 区 坐标 系 
if (!m_dragImage->BeginDrag(beginDragHotSpot, this) ) 
{ 
delete m_dragImage; 
m_dragImage = NULL; 
m_dragMode = TEST_DRAG_NONE; 
} else 
{ 
m_dragImage->Move(event.GetPosition()); 
m_dragImage->Show(); 


} 


else if (m_dragMode == TEST_DRAG_DRAGGING) 


// 移动 这 个 图 片 
m_dragImage->Move(event.GetPosition()); 


如 果 你 希望 自己 绘制 用 于 拖 动 的 图 片 而 不 是 使 用 一 个 位 图 ,你 可 以 实现 一 个 
wxGenericDraglmageBU se # Æ AH wxDraglmage::DoDrawlmageH 2X #0 
wxDraglmage::GetlmageRect 函 数 .在 非 windows 的 平台 上 , wxDraglmage 是 


wxGenericDraglmage 的 一 个 别名 而 已 ,而 Windows 平 台 上 实现 的 wxDraglmage 不 支持 
DoDrawlmage 函 数 , 也 限制 只 能 绘制 有 时 候 显 得 有 点 恐怖 的 半 透 明 图 片 ,因此 ,你 可 以 考虑 在 所 
有 的 平台 上 都 使 用 wxGenericDraglmage 类 . 


当 你 开始 拖 动 操作 的 时 候 ,就 在 正 准备 调用 wxDraglmage::Show 郴 数 之 前 ,通常 你 需要 现在 屏幕 
上 擦 除 你 要 拖 动 的 对 象 ,这 可 以 使 得 wxDraglmage 保 存 的 背景 中 没有 正在 拖 动 的 对 象 ,因此 整 


这 种 闪烁 ( 仅 适 用 于 使 用 wxGenericDraglmage 的 情况 ), 你 可 以 重 载 wxGenericDraglmage 的 
UpdateBackingFromWindow 郴 数 ,使 用 传递 给 你 的 设备 上 下 文 绘 制 一 个 不 包含 正在 拖 动 对 象 
的 背景 ,然后 你 就 不 需要 在 调用 wxDraglmage::Show 郴 数 之 前 擦 除 你 要 抑 动 的 对 象 了 ,整个 拖 
动 过 程 的 屏幕 就 将 会 是 平滑 而 无 闪烁 的 了 . 


第 十 一 草 小 结 


在 这 一 章 里 ,我 们 看 到 了 怎样 料 数据 传输 到 剪贴 板 上 或 者 怎样 从 剪贴 板 获 取 数 据 .我 们 也 了 解 了 
怎样 从 拖 放 源 的 角度 以 及 拖 放 目 的 的 角度 实现 拖 放 操作 .还 了 解 了 wxWidgets 中 和 拖 放 相 关 的 
一 些 其 他 领域 的 知识 .更 深入 的 了 解 请 参考 wxWidgets 的 samples/dnd, samples/dragimag 和 
samples/treectrl 目 录 中 的 例子 . 


在 下 一 章 里 ,我 们 将 回 到 窗口 类 相关 的 主题 ,介绍 一 些 高 级 的 窗口 类 以 及 怎样 通过 它们 让 你 的 应 
用 程序 进入 一 个 更 新 的 层级 . 


第 十 二 章 高 级 窗口 控件 


显然 我 们 不 能 在 这 里 列举 wxWidgets 提 供 的 所 有 的 控件 ,但 是 还 是 有 必要 对 其 中 几 个 更 高 级 一 
点 的 控件 作 一 些 介绍 , 以 便 在 需要 的 时 候 你 可 以 更 好 的 使 用 它们 .本 章 履 盖 的 内 容 包括 下 面 的 主 


题 : 


wxTReeCtrl; 这 个 控件 用 来 帮助 你 为 分 等 级 的 数据 建 模 . 

wxListCtrl; 这 个 控件 让 你 以 灵活 的 方式 显示 一 组 文本 标签 和 图 标 . 

wxWizard; 这 个 控件 使 用 多 个 页 面 对 某 个 特定 的 任务 提供 向 导 机 制 |. 

wxHtmlWindow; 你 可 以 在 "关于 "对 话 框 和 报告 对 话 框 (以 及 其 他 你 可 以 想到 的 对 话 框 ) 中 使 
用 的 轻 量 级 的 HTML 显 示 控 件 . 

wxGrid; 网 格 控件 用 是 一 个 支持 多 种 特性 的 标 状 数据 显示 控件 . 

wxTaskBarlcon; 这 个 控件 让 你 的 程序 可 以 很 容易 的 访问 系统 托盘 区 或 者 类 似 的 区 域 . 
编写 自 定 义 的 控件 . 介绍 了 制作 一 个 专业 级 的 自 定 义 控 件 必须 的 几 个 步 又 


12.1 wxTreeCtrl 


树 状 控件 以 层 的 形式 展示 信息 , 它 的 子 项 可 以 展开 也 可 以 合并 .下 图 演示 了 wxWidgets 的 树 状 控 
件 例子 , 它 正 以 不 同 的 字体 和 风格 以 及 颜色 进行 展示 .每 一 个 树 状 控件 的 子 项 都 代表 一 个 
wxtreeltemld 对 象 , 它 拥有 一 个 文本 标签 和 一 个 可 选 图 标 ,并 且 文 本 和 图 标的 内 容 都 可 以 动态 修 
改 . 树 状 控件 可 以 以 单 选 或 者 多 选 的 形式 创建 .如 果 你 希望 在 wxtreeltemld 上 绑 定 一 些 数 据 ,你 需 
要 实现 自己 的 wxTreeltemData 派 生 类 ,然后 调用 wxTreeCtrl::SetltemDataky AK 
wxTreeCtrl::GetltemData 汞 数 .这 个 数据 在 子 项 被 释放 的 时 候 将 会 被 一 并 释放 (delete 调 用 ), 如 
果 你 将 其 指向 你 实际 的 数据 ,需要 注意 避免 重复 释放 . 


i wxTreeCtrl Test 
File Style Tree Item 
=| BS Root 
= 
File child 1.1 
File child 1.2 
File child 1.3 
L Folder child 2 
LJ Folder child 3 
J Folder child 4 
(J Folder child 5 


+ 
+ 
+ 
+ 


12:09:21: Tree key down event MENU [flags = 这--] A 
12:09:21: Tree key down event: MENU [flags = -A--] 
12:09:22: Tree key down event: MENU [flags = -A--] 
12:09:30: Tree key down event MENU [flags = -A--] 


v 





Root/last item is visible» 


为 应 用 程序 可 以 检测 到 树 状 控件 的 子 项 被 单 击 的 事件 ,你 可 以 用 这 个 特点 通过 更 改 子 项 的 
片 来 达到 模拟 其 他 的 控件 的 目的 .比如 说 ,你 可 以 很 容易 用 树 状 控件 的 子 项 来 模拟 一 个 复 选 框 . 


下 面 的 代码 演示 了 怎样 创建 一 个 树 状 控件 ,定义 其 子 项 的 绑 定 数据 以 及 图 片 : 


#include "wx/treectrl.h" 
// 声明 一 个 代表 和 子 项 绑 定 的 数据 的 类 
class MyTreeItemData : public wxTreeItemData 


public: 
MyTreeItemData(const wxString& desc) : m_desc(desc) { } 
const wxString& GetDesc() const { return m_desc; } 
private: 
wxString m_desc; 


J; 
// 子 项 相关 的 图 片 
#include "file.xpm" 
#include "folder.xpm" 
// 创建 一 个 树 状 控件 
wxTreeCtr1* treeCtrl = new wxTreeCtr1( 
this, wxID_ANY, wxPoint(0, ©), wxSize(400, 400), 
wxTR_HAS_ BUTTONS |wxTR_SINGLE) ; 
wxImageList* imageList = new wxImageList(16, 16); 
imageList ->Add(wxIcon(folder_xpm) ; 
imageList ->Add(wxIcon(file_xpm) ; 
treeCtr1->AssignImageList(imageList); 
// 根 节点 使 用 文件 夹 图 标 , 而 两 个 字 节 点 使 用 文件 图 标 
wxTreeItemId rootId = treeCtr1->AddRoot(wxT("Root"), 0, 0, 
new MyTreeItemData(wxT("Root item"))); 
wxTreeItemId itemId1 = treeCtrl->AppendItem(rootId, 
wxT("File 1"), 1, 1, 
new MyTreeItemData(wxT("File item 1"))); 
wxTreeItemId itemId2 = treeCtrl->AppendItem(rootId, 
wxT("File 2"), 1, 1, 
new MyTreeItemData(wxT("File item 2"))); 


wxTreeCtrl 的 窗口 类 型 


wxTreeCtrl 有 如 下 表 所 示 的 人 额外 的 窗口 类 型 : 


wxtr DEFAULT_STYLE 


wxtr_EDIT_ LABELS 
wxtr_NO_BUTTONS 
wxtr_HAS_BUTTONS 
wxTR_NO_LINES 


wxtr_FULL_ROW_HIGHLIGHT 


wxtr_LINES_AT_ ROOT 


wxtr_HIDE_ROOT 


wxtr_ROW_LINES 


wxTR_HAS_VARIABLE_ROW_HEIGHT 


wxtr_SINGLE 
wxtr_MULTIPLE 


wxtr_EXTENDED 


wxTreeCtrl 的 事件 


这 个 值 是 各 个 平台 上 树 状 控件 实现 和 默认 值 


最 接近 的 值 

是 否 子 项 文本 可 编辑 

不 必 显 示 用 于 展开 或 者 合并 子 项 的 按 馈 
显示 用 于 展开 或 者 合并 子 项 的 按 馈 

不 必 显 示 用 于 表示 层级 关系 的 垂直 虚线 


当选 中 某 个 子 项 的 时 候 高 亮 显示 整 行 (在 
windows 平 台 上 ,除非 设置 了 
WwWxtr NO_LINES ,否则 这 个 类 型 将 被 忽略 ) 


显示 根 节 点 之 间 的 连 线 .这 1 Pe LATE 
设置 wxtr_ HIDE ROOT 并 且 没 有 设 
wxtr NO_LINES 的 时 候 有 效 


不 显示 根 节 点 ,这 将 导致 第 一 
一 系列 根 节 点 


使 用 这 个 类 型 在 已 显示 的 行 之 间 绘 制 一 个 高 
对 比 的 边界 


设置 这 个 类 型 允许 各 行 采 用 不 同 的 高 度 ,否则 
各 行 都 将 采 用 和 最 大 的 行 高 同样 的 高 度 .这 文 个 
均 色 适用 于 树 状 控件 的 标准 实现 (而 非 各 个 平 
台 的 原生 实现 ) 


层 的 字 节 点 成 为 


单 选 模式 

多 选 模式 

人 允许 多 选 非 连续 的 子 项 (该 功能 仅 是 部 分 实 
现 ) 


树 状 控 件 产 生 wxtreeEvent 类 型 的 事件 ,这 种 事件 可 以 在 父子 关系 的 窗口 之 间 传 递 


EVT_TREE_BEGIN_DRAG(id, 
func)EVT_TREE_BEGIN_RDRAG(id, 
func) 


EVT_TREE_BEGIN LABEL EDIT(id, 
func) EVT_TREE_END LABEL EDIT(id, 
func) 


EVT_TREE_DELETE_ITEM(id, func) 
EVT_TREE_GET_INFO(id, func) 
EVT_TREE_SET_INFO(id, func) 


EVT_TREE_ITEM_ACTIVATED(id, func) 


EVT_TREE_ITEM_COLLAPSED(id, 
func) 


EVT_trEE_ITEM_COLLAPSING(id, func) 
EVT_TREE_ITEM_EXPANDED(id, func) 


EVT_TREE_ITEM_EXPANDING(id, func) 


EVT_TREE_SEL_CHANGED(id, func) 


EVT_TREE_SEL_CHANGING(id, func) 


EVT_TREE_KEY_DOWN(id, func) 


EVT_TREE_ITEM_GET_TOOLTIP(id, 
func) 


wxTreeCtrl 的 成 员 画 数 


在 用 户 开始 拖 放 操作 的 时 候 产 生 ,这 个 事件 
的 使 用 细节 请 参考 第 11 章 ," 剪 贴 板 和 拖 放 操 
作 " 


当 用 户 开 始 编辑 或 者 刚刚 完成 编辑 子 项 标签 
的 时 候 产 生 

当 某 个 子 项 被 删除 的 时 候 产 生 

当 某 个 子 项 的 数据 被 请 求 的 时 候 产 生 

当 某 个 子 项 的 数据 被 设置 的 时 候 产 生 

当 某 个 子 项 被 激活 (双击 或 者 使 用 键 瘟 选择 ) 
的 时 候 产 生 

给 定 的 子 项 已 被 收缩 (合并 ) 的 时 候 产 生 

给 定 的 子 项 即将 收缩 (合并 ) 的 时 候 产 生 , 这 个 
事件 可 以 被 Veto 以 阻止 收缩 . 

给 定子 项 已 被 展开 的 时 候 产 生 


给 定子 项 即将 展开 的 时 候 产 生 , 这 个 事件 可 
以 被 Veto 以 阻止 展开 


选中 的 子 项 发 生变 化 以 后 (新 的 子 项 被 选中 
或 者 旧 的 选中 项 不 被 选中 的 时 候 ) 产 生 


选中 的 子 项 即将 发 生变 化 的 时 候 产 生 , 该 事 
件 可 以 被 Veto 以 阻止 变化 产生 


仿 测 针对 该 树 状 控件 的 键盘 事件 


这 个 事件 仅 支 持 windows 平 台 , 它 使 得 你 可 
以 给 某 个 子 项 设置 单独 的 工具 提示 


下 面 列 出 了 wxTreeCtrl 控 件 的 一 些 重要 的 成 员 画 数 . 


使 用 AddRoot 函 数 增加 第 一 个 子 项 ,然后 使 用 Appendltem, Insertltem 或 Prependltem 来 增加 随 
后 的 子 项 .使 用 Delete 移 除 一 个 子 项 ,使 用 DeleteAllltems 删 除 某 个子 项 所 有 的 子 项 ,或 者 使 用 


DeleteChildren 删 除 某 个 子 项 的 所 有 直接 子 项 . 


使 用 SetltemText 设 置 某 个 子 项 的 标签 ,使 用 


SetltemTextColour, SetltemBackgroundColour SetltemBold 和 SetltemFont 来 设置 标签 的 外 观 . 


如 果 你 想 给 某 个子 项 指定 一 幅 图 片 ,首先 需要 使 用 SetlmageList 函 数 将 某 个 图 片 列表 和 这 个 树 
状 控件 绑 定 .每 个 子 项 可 以 指定 四 个 状态 的 图 片 ,分 别 是 
wxTReeltemlcon Normal,wxTReeltemlcon_Selected, wxtreeltemlcon_Expanded 和 


wxTReeltemlcon_SelectedExpanded, 你 可 以 使 用 SetltemlmageHN BAS MA AT EA 
片 列 表 中 图 片 索引 .如 果 你 只 给 wxTReeltemlcon_Normal 状 态 指定 了 一 个 索引 ,那么 别 的 状态 也 
将 都 使 用 这 个 图 片 . 


使 用 Scroll 画 数 以 便 将 某 个 子 项 移动 到 可 见 区 域 ,使 用 EnsureVisible 使 得 这 个 子 项 在 需要 的 时 候 
展开 以 便 其 可 以 位 于 可 见 区 域 .使 用 Expand 画 数 展开 某 个 子 项 ,Collapse 和 CollapseAndReset 
函数 合并 某 个 子 项 ,后 者 还 将 移 除 其 所 有 的 子 项 ,如 果 你 正在 使 用 的 树 状 控 件 有 很 多 子 项 ,你 可 能 
希望 只 增加 可 见 部 分 的 子 项 以 便 提高 性 能 .在 这 种 情况 下 ,你 可 以 处 理 
EVT_TREE_ITEM_EXPANDING 事 件 , 在 需要 的 时 候 才 增加 子 项 ,在 收缩 的 时 候 则 移 除 所 有 子 
项 .而 且 你 还 需要 调用 SetltemHasChildren 函 数 以 便 没有 子 项 的 子 项 也 可 以 显示 一 个 可 扩展 按 
钮 ,即使 它 真 的 没有 . 


使 用 Selectltem 选 择 或 者 去 选择 某 个 子 项 .如 果 是 单 选 类 型 ,你 可 以 使 用 GetSelection 函 数 得 到 
正 被 选中 的 子 项 ,如 果 当 前 没有 子 项 被 选中 , 则 返回 一 个 未 初始 化 的 wxTReeltemld, 你 可 以 调用 
wxTreeltemld::lIsOk 函 数 来 判断 其 有 效 性 .而 对 于 多 选 类 型 ,你 可 以 使 用 GetSelections 函 数 获取 
当前 选中 的 子 项 ,你 需要 传递 一 个 wxArrayTreeltemltemlds 类 型 的 引用 作为 参数 . Unselect 画 数 
在 单 选 情况 下 去 选中 当前 的 子 项 ,而 UnselectAlI 画 数 则 用 在 多 选 情况 下 去 选中 所 有 正 被 选中 的 
子 项 ,Unselectltem 画 数 可 以 用 来 在 多 选 情况 下 去 选中 某 一 个 子 项 . 


通 历 某 个 树 状 控 件 的 所 有 子 项 也 有 多 种 方法 :你 可 以 先 使 用 GetRootltem 函 数 获得 根 节点 ,然后 


ANFAS 


使 用 GetFirstChild 和 GetNextChildia 4 PTA 2. (2 FA GetNextSibling#1 GetPrevSibling R% 


而 GetChildrenCount 则 返回 某 个 子 项 的 字 节 点 的 数目 . 


HitTest 函 数 在 实现 你 自己 拖 放 的 时 候 是 很 有 用 的 , 它 使 得 你 可 以 通过 鼠标 位 置 找 到 这 个 位 置 对 
应 的 子 项 以 及 子 项 的 某 个 特定 部 分 .具体 返回 值 请 参考 相关 手册 中 的 内 容 .使 用 
GetBoundingRect 函 数 可 以 得 到 某 个子 项 对 应 的 矩形 区 域 . 


更 多 关于 树 状 控件 的 信息 请 参考 使 用 手册 以 及 samples/treectrl 中 的 wxTreeCtrl 例 子 . 


wxWidgets 跨 平 台 GUI 编程 


12.2 wxListCtrl 


列表 控件 使 用 四 种 形式 中 的 一 种 来 显示 子 项 :多 列 视图 ,多 列 报告 视图 ,大 图 标 方式 以 及 小 图 标 方 
式 . 下 图 分 别 对 齐 进 行 了 演示 .每 一 个 子 项 使 用 一 个 长 整 型 的 索引 来 表示 的 , 随 着 子 项 的 增加 , 删 
除 以 及 排序 ,这 个 索引 可 能 发 生变 化 .和 树 状 控件 不 同 ,列表 框 默 认 采 用 人 允许 多 选 的 方式 ,不 过 你 
还 是 可 以 在 创建 窗口 的 时 候 通 过 类 型 指定 只 人 允许 单 选 .如 果 你 需要 对 所 有 子 项 进行 排序 ,你 可 以 
提供 一 个 排序 函数 .在 多 列 报告 视图 中 ,可 以 给 每 一 列 增加 一 个 标题 ,点 过 拦截 标题 单 击 事件 可 以 
实现 一 些 附加 操作 比如 按 当 前 列 进 行 排序 .每 一 列 的 宽度 既 可 以 通过 代码 改变 ,也 可 以 通过 用 户 
使 用 鼠标 拖 搜 来 改变 . 


i, wxListCtrl Test 


File View List Colour 





Column 1 Column 2 Column 3 
"eq This is item 0 Col 1, item 0 Item 0 in column 2 
"= This is item 1 Col 1, item 1 Item 1 in column 2 


向 This is item 5 Col 1, item 5 Item 5 in column 2 
"a This is item 6 Col 1, item 6 Item 6 in column 2 


FR, Thie ie ikam 了 Colt ikam? _ Therm Fin rrlirnr 2 
12:13:41: Value of the 2nd field of the selected item: Col 1, item 3 
12:13:47: OnColBeginDrag: column 1 [width = 78 or 78). 

12:13:48: OnColEndDrag: column 1 [width = 120 or 120). 
12:13:52: Item 3: OnListKeyD own [item text = This is item 3, data = 3) 


i wx1istCtrl Test 


File wiew List Colour 





Item 0 Item 9 Item 18 Item 27 
Item 1 Item 10 Item 19 Item 28 
Item 2 Item 11 Item 20 Item 29 
Item 3 Item 12 Item 21 
Item 4 Item 13 Item 22 
Item 5 Item 14 Item 23 
Item 6 Item 15 Item 24 
Item 7 Item 16 Item 25 
Item 8 Item 17 Item 26 





12.2 wxListCtrl 


CD 
N 
N 


wxWidgets 跨 平台 GUI 编程 





i wxListCtrl Test 


File wiew List Colour 


= © Vv DB 


Label 0 Label 1 Label 2 Label 3 


? > 9 P 


Label 4 Label 5 Label 6 Label 7 











12:17:19: Item 1: OnFocused [item text = Label 1, data = 0) 
12:17:19: Item 1: OnSelected [item text = Label 1, data = 0) 
12:17:20: Item 1: OnListKeyD own [item text = Label 1, data = 0) 


i wx1istCtrl Test 


File wiew List Colour 





T Label 0 ™ Label 1 a Label 2 
a Label 3 Ta Label 4 a Label 5 
r Label 6 Ta Label 7 r Label 8 











列表 控件 的 每 个 子 项 同样 可 以 绑 定 一 些 客户 区 数据 ,但 是 和 树 状 控件 不 同 ,每 一 个 列表 框 的 子 项 
只 能 绑 定 一 个 长 整 型 数据 .如 果 你 希望 给 每 一 个 子 项 绑 定 一 个 特定 对 象 ,你 需要 自己 实现 一 个 从 
长 整 型 到 特定 数据 对 象 之 间 的 隐 射 ,并 且 自 己 负责 那些 数据 对 象 的 创建 和 释放 . 


wxListCtrl 的 窗口 类 型 


12.2 wxListCtrl 323 


wxLC_LIST 


wxLC_REPORT 
wxLC_VIRTUAL 


wxLC_ICON 
wxLC_SMALL_ICON 
wxLC_ALIGN_TOP 
wxLC_ALIGN_LEFT 
wxLC_AUTO_ARRANGE 
wxLC_EDIT_LABELS 
wxLC_NO_ HEADER 
wxLC_SINGLE_SEL 


wxLC_SORT_ASCENDING 


wxLC_SORT_DESCENDING 


wxLC_HRULES 
wxLC_VRULES 


wxListCtrl (4 


使 用 可 选 的 小 图 标 进行 多 列 显示 . 列 数 是 自动 计算 的 ,不 
需要 设置 象 wxLC_REPORT 那 样 设置 列 数 , 换 句 话说 ,这 
只 是 一 个 自动 换行 的 排列 

单列 或 者 多 列 报 告 方式 ,并 且 可 以 设置 可 选 的 标题 . 


指定 显示 的 文本 由 应 用 程序 动态 提供 ; 只 能 用 于 
wxLC_REPORT 方 式 . 


大 图 标 方式 显示 ,可 选 显示 文本 标签. 

小 图 标 方式 显示 ,可 选 显示 文本 标签 

标 顶 端 对 齐 . 仅 适用 于 Windows. 

图 标 左 对 齐 . 

标 自动 排列 . 仅 适用 于 Windows. 

标签 可 编辑 ; 当 编 辑 动作 开始 时 应 用 程序 将 收 到 通知 . 
在 报告 模式 下 不 显示 标题 . 

指定 单 选 模式 ; 默认 为 多 选 模式 . 


从 小 到 大 排序 . 应 用 程序 需要 在 Sortltems 中 提供 自己 的 
排序 函数 


从 大 到 小 排序 . 应 用 程序 需要 在 Sortltems 中 提供 自己 的 
排序 函数 


在 报告 模式 中 显示 每 行 之 间 的 标尺 . 
在 报告 模式 中 显示 每 列 之 间 的 标尺 . 


wxListCtrl 产 生 wxListEvent 类 型 的 事件 ,如 下 表 所 示 , 事 件 可 以 父子 窗口 之 间 传 
递 ,WXxListEvent::Getlndex 可 以 用 来 返回 针对 单个 子 项 的 事件 中 的 子 项 索引 . 


EVT_LIST_BEGIN_DRAG(id, func) 
EVT_LIST_BEGIN_RDRAG(id, 
func) 


EVT_LIST BEGIN LABEL EDIT(id, 
func) 
EVT_LIST_END LABEL EDIT(id, 
func) 


EVT_LIST_DELETE_ITEM(id, func) 
EVT_LIST_DELETE_ALL_ITEMS(id， 
func) 


EVT_LIST_ITEM_SELECTED(id, 
func) 
EVT_LIST_ITEM_DESELECTED(id, 
func) 


EVT_LIST_ITEM_ACTIVATED(id, 
func) 


EVT_LIST_ITEM FOCUSED(id, 
func) 


EVT_LIST_ITEM_MIDDLE_CLICK(id, 


func) 
EVT_LIST_ITEM_RIGHT_CLICK(id, 
func) 


EVT_LIST_KEY_DOWN(id, func) 


EVT_LIST_INSERT_ITEM(id, func) 


EVT_LIST_COL_CLICK(id, func) 
EVT_LIST_COL_RIGHT_CLICK(id, 
func) 


EVT_LIST_COL BEGIN DRAG(id, 
func 
EVT_ LIST _COL_DRAGGING(id, 
func) 
EVT_LIST _COL_END_DRAG(id, 
func) 


~ | 


EVT_LIST_CACHE_HINT(id, func) 


wxListltem 


这 个 事件 在 拖 放 开始 的 时 候 产生 ,如 果 要 实现 拖 
放 , 你 需要 提供 拖 放 操作 的 剩 下 的 部 分 .通过 
wxListEvent::GetPointis 24 3 BX 4 BUY BS Ar {i 
ia. 


用 户 正 准备 编辑 标签 或 者 结束 编辑 的 时 候 产生 ， 
使 用 Veto 函 数 可 禁止 这 种 编辑 行 
为 .wxListEvent::GetText 则 返回 当前 的 标签 . 


事件 在 某 个 子 项 被 删除 或 者 所 有 的 子 项 都 被 删 
除 的 时 候 产 生 . 


在 子 项 的 选中 状态 发 生 改 变 的 时 候 产生 . 


在 某 个 子 项 被 激活 (鼠标 双击 或 者 通过 键盘 ) 的 时 
候 产 生 . 


当当 前 焦点 子 项 发 生 改变 的 时 候 产 生 . 


在 子 项 被 鼠标 以 中 键 或 者 右键 单 击 的 时 候 产生 


在 有 针对 列表 控件 的 按键 事件 的 时 候 产 生 . 使 用 
wxListEvent::GetKeyCode AS EAIA 
的 编码 . 


新 的 子 项 插入 的 时 候 产 生 . 


某 一 列 被 单 击 的 时 候 产 生 . 使 用 
wxListEvent::GetColumnby 2x 3 4k % # b95 
索引 . 


列 大 小 发 生 改 变 的 时 候 或 者 结束 改变 的 时 候 产 
生 . 你 可 以 使 用 Veto 函 数 来 禁止 这 种 改变 .使 用 
wxListEvent::GetColumn # ##* KN USS. 


如 果 你 正在 实现 一 个 续 列表 控件 ,你 可 能 想 在 某 
一 组 子 项 被 显示 之 前 更 新 其 内 部 数据 .这 个 事件 
通知 你 进行 这 个 操作 的 最 合适 的 时 机 .使 用 
wxListEvent::GetCacheFromE Ail 
wxListEvent::GetCache Toa # 15 BUS Bt 
的 子 项 的 索引 范围 . 


你 需要 使 用 wxListltem 这 个 类 在 列表 控件 中 进行 插入 ,设置 子 项 属性 或 者 获取 子 项 属性 的 操作 . 
SetMask 函 数 用 来 指示 你 希望 使 用 的 列表 子 项 属性 ,如 下 表 所 示 : 


wxLIST_MASK_STATE state 属 性 有 效 . 
wxLIST_MASK_TEXT text 属 性 有 效 . 
wxLIST_MASK_IMAGE image 属 性 有 效 . 
wxLIST_MASK_DATA data 属 性 有 效 . 
wxLIST_MASK_WIDTH width 属性 有 效 . 
wxLIST_MASK_FORMAT format 属 性 有 效 . 


使 用 Setld 函 数 设置 子 项 基于 0 的 索引 值 ,使 用 SetColumn 画 数 设置 当 控 件 在 报告 模式 时 基于 0 的 
列 索 引 . 


SetState 函 数 则 用 来 设置 下 表 所 示 的 子 项 状态 : 
wxLIST_STATE_DONTCARE 不 关心 子 项 状态 . 


wxLIST_STATE_DROPHILITED 子 项 正 被 高 之 显示 以 便 接 受 一 个 拖 放 中 的 放置 事件 


( 仅 适用 于 Windows). 
wxLIST_STATE_FOCUSED 子 项 正 拥有 焦点 
wxLIST_STATE_SELECTED FRERET. 
wxLIST_STATE_CUT FAERIE FA FWindows). 


SetStateMask 则 用 来 设置 当前 正在 更 改 的 状态 ,参数 和 上 表 中 的 值 相 同 . 


SetText 辑 数 用 来 设置 标签 或 者 标题 文本 .Setlmage 函 数 用 来 设置 子 项 的 图 片 在 图 片 列表 中 的 索 
Bl. 


SetData 函 数 则 用 来 设置 和 子 项 绑 定 的 长 整 型 客户 区 数据 . 


SetFormat 画 数 用 来 设置 列表 模式 时 的 对 齐 模式 ,其 值 为 wxLIST_FORMAT_LEFT, 
wxLIST_FORMAT_RIGHT 或 wxLIST_FORMAT_CENTRE( 或 者 
wxLIST_FORMAT_CENTER), SetColumnWidth 范 数 则 可 以 用 来 设置 列 宽 . 


还 有 一 些 其 它 的 可 视 属性 可 以 通过 下 面 的 这 些 函 数 设 置 :SetAlign, SetBackgroundColour, 
SetTextColour 和 SetFont. 这 些 属性 不 需要 设置 掩 码 标记 .并 且 所 有 Set 函 数 都 拥有 一 个 对 应 的 
Get 画 数 来 获取 相应 的 设置 . 


下 面 的 代码 用 wxListltem 来 选择 第 二 个 子 项 ,并 且 设 置 其 文本 标签 以 及 字体 颜色 . 


wxListItem item; 

item.SetId(1); 
item.SetMask(wxLIST_MASK_STATE|wxLIST_MASK_TEXT); 
item.SetStateMask(wxLIST_STATE_SELECTED) ; 
item.SetState(wxLIST_STATE_SELECTED) ; 
item.SetTextColour (*wxRED); 

item.SetText(wxT("Red thing")); 
listCtrl->SetItem(item); 


你 也 可 以 直接 通过 另外 的 函数 来 设置 这 些 属 性 .比如 SetltemText, Setltemlmage, SetltemState, 
GetltemText, Getltemlmage, GetltemState $3, Ki] 4 Eni ik Bil ax HE RK. 


wxListCtr| 成 员 画 数 
在 windows 平 台 上 可 以 调用 Arrange 阔 数 在 大 图 标 或 者 小 图 标的 方式 下 进行 排列 图 标 . 


AssignlmageList 给 列表 控件 绑 定 一 个 图 标 列表 ,图 形 列 表 的 释放 由 列表 控件 负责 ,SetlmageList 
也 可 以 实现 同样 的 功能 ,不 过 图 片 列表 的 释放 由 应 用 程序 自己 负责 ,使 用 
wxIMAGE_LIST_NORMAL 或 wxIMAGE_LIST_SMALL 来 指定 用 于 哪 种 显示 形 

式 ,GetlmageList 则 用 来 获取 对 应 的 图 片 列表 指针 . 


Insertltem 函 数 用 来 在 控件 的 特定 位 置 中 插入 一 个 子 项 .可 以 传递 的 参数 包括 几 种 形式 :直接 传 
递 已 经 设置 了 成 员 变 量 的 wxListltem 对 象 .或 者 一 个 索引 和 一 个 字符 串 , 一 个 索引 和 一 个 图 片 索 
引 以 及 一 个 索引 ,一 个 标签 和 一 个 图 片 索 引 等 . InsertColumn 函 数 则 用 来 在 报告 视图 中 插入 一 
Al. 


ClearAll EX HRA MF RURRE RAPHE HAAA FT WR MRS 
件 .DeleteAllltems 删 除 所 有 的 子 项 并 产生 所 有 的 子 项 被 删除 的 事件 .Deleteltem 删 除 某 一 个 子 项 
并 产生 子 项 被 删除 事件 .DeleteColumn 则 用 来 删除 报告 视图 中 的 某 一 列 . 


Setltem 画 数 通过 传递 一 个 wxListltem 变 量 来 设置 某 个 子 项 的 属性 ,就 象 前 面 例子 中 的 那样 ,或 者 
你 还 可 以 传递 一 个 索引 ,一 个 列 , 一 个 标签 以 及 图 片 索引 参数 .Getltem 则 用 来 查询 那些 经 由 
wxListltem::Setld 函 数 设 置 的 子 项 索引 的 信息 . 


SetltemData 函 数 用 来 给 某 个 子 项 绑 定 一 个 长 整数 .在 绝 大 多 数 的 平台 上 ,都 可 以 将 一 个 指针 强 
制 转 换 成 长 整数 ,以 便 这 里 可 以 设置 一 个 指针 ,但 是 某 些 平台 上 ,这 样 作 是 不 适合 的 ,这 时 候 你 可 
以 通过 一 个 哈 希 映射 来 将 一 个 长 整数 和 某 个 对 象 对 应 .GetltemData 则 返回 某 个 子 项 绑 定 的 长 
整数 .需要 注意 的 是 , 子 项 的 位 置 随 着 其 它 子 项 的 插入 或 者 删除 以 及 排序 操作 ,将 会 发 生 改 变 , 因 
此 不 适合 用 来 素 引 一 个 子 项 ,但 是 子 项 绑 定 的 客户 数据 是 不 会 随 子 项 位 置 的 变化 而 变化 的 ,可 以 
用 来 唯一 标识 一 个 子 项 . 


Setltemlmage 男 数 采 用 子 项 索引 和 图 片 索 引 两 个 参数 给 某 个 子 项 指定 一 个 图 标 . 


SetltemState 用 来 设置 子 项 的 某 个 状态 值 ,必须 通过 一 个 掩 码 来 指定 哪个 状态 的 值 将 改变 ,参考 
前 面 介绍 wxListltem 的 部 分 .GetltemState 则 用 来 返回 某 个 给 定子 项 的 状态 . 


SetltemText 函 数 和 GetltemText 函 数 用 来 设置 和 获取 某 个 子 项 的 文本 标签 . 


SetTextColour 用 来 设置 所 有 子 项 的 文本 标签 的 颜色 ,SetBackgroundColour 则 用 来 设置 控件 的 
背景 颜色 . SetltemTextColour 和 SetltemBackgroundColour 用 来 设置 在 报告 模式 下 某 个 单独 子 
RAMA RAMS SB. ERMA ot Get. 


使 用 EditLabel 函 数 开始 编辑 某 个 子 项 的 标签 ,这 将 会 导致 一 个 
wxEVT_LIST_BEGIN_LABEL _EDIT 事 件 .你 可 以 通过 这 个 事件 的 GetEditControl 函 数 获得 对 应 
编辑 控件 的 指针 ( 仅 适用 于 windows). 


EnsureVisible 将 使 得 指定 的 子 项 处 于 可 见 区 域 .ScrollList 用 来 在 某 个 方向 上 滚动 指定 的 象 素 ( 仅 
适用 于 windows),Refreshltem 用 来 刷新 某 个 子 项 的 显示 ,Refreshltems 则 用 来 刷新 一 系列 子 项 
的 显示 ,这 两 个 玉 数 主要 用 在 使 用 虚 列表 控件 而 子 项 的 内 部 数据 已 经 改变 时 .GetTopltem 用 于 在 
列表 或 者 报告 视图 中 返回 第 一 个 可 见 的 子 项 . 


Findltem 可 以 被 用 来 查找 指定 标签 ,客户 区 数据 或 者 位 置 的 子 项 .GetNextltem 则 用 来 查找 某 些 
指定 状态 的 子 项 (比如 所 有 正 被 选中 的 子 项 ).HitTest 函 数 用 来 返回 给 定位 置 的 子 

项 .GetltemPosition 返 回 大 图 标 或 者 小 图 标 视图 中 某 个 子 项 的 相对 于 客户 区 的 起 始 座 

标 .GetltemRect 则 返回 相对 于 客户 区 的 座 标 以 及 子 项 所 占 的 大 小 . 


你 可 以 动态 改变 列表 控件 的 显示 类 型 而 不 需要 先 释放 表 重 新 创建 它 : 使 用 SetSingleStyle 函 数 指 
定 一 个 类 型 ,比如 wxLC_REPORT. 指 定 false 参 数 来 移 除 某 一 个 显示 类 型 . 


在 报告 模式 中 使 用 SetColumn 函 数 来 设置 某 列 的 信息 ,比如 标题 或 者 宽度 ,参考 前 面 的 
wxListltem 的 相关 介绍 ,作为 一 个 简单 的 替代 版 本 ,SetColumnWidth 用 来 直接 设置 某 个 列 的 宽 
度 .使 用 GetColumn 和 GetColumnWidth 来 获取 对 应 的 设置 .而 GetColumnCount 则 用 来 获取 当 
前 的 列 数 . 


GetltemCount 函 数 用 来 返回 列表 控件 中 子 项 的 数目 ,GetSelectedltemCount 芳 数 则 用 来 返回 选 
lie ees Se 芭 回 所 有 子 项 的 数目 ,而 在 列表 和 报 
告 模式 中 返 见 区 域 可 以 容纳 的 子 项 的 数目 . 


最 后 ,Sortltems 画 数 可 以 被 用 来 对 列表 控件 中 的 子 项 进行 排序 .这 个 画 数 的 参数 为 比较 函数 
pee Sultans RTI WAERAMDSRMABART Mat BE PRE, BA 
个 更 深入 的 整数 , 然 会 另外 一 个 整数 ,如 果 两 个 子 项 比较 的 结果 为 相等 , 则 返回 0, 前 一 个 大 于 后 一 
个 则 返回 正 数 ， ee 个 则 返回 负数 .当然 ,为 了 排序 功能 更 好 的 工作 ,你 需要 给 每 个 子 
项 指定 一 个 长 整 型 的 客户 区 数据 (可 以 通过 wxListltem::SetDataby a). x HE 户 区 数据 被 传递 

给 比较 函数 以 实现 比较 . 


使 用 wxListCtrl 


下 面 的 代码 创建 和 显示 了 一 个 报告 模式 的 列表 控件 ,这 个 列表 控件 公有 三 列 10 个 子 项 ,每 一 行 开 
始 的 地 方 都 会 显示 一 个 16x16 的 文件 图 标 : 


#include "wx/listctr1l.h" 
// 报告 模式 中 的 图 片 
#include "file.xpm" 
#include "folder. xpm" 
// 创建 一 个 报告 模式 的 列表 控件 
wxListCtr1* listCtrlReport = new wxListCtr1( 

this, wxID_ANY, wxDefaultPosition, wxSize(400, 400), 

wxLC_REPORT |wxLC_SINGLE_SEL); 
// 绑 定 一 个 图 片 列表 
wxImageList* imageList = new wxImageList(16, 16); 
imageList ->Add(wxIcon(folder_xpm) ); 
imageList ->Add(wxIcon(file_xpm) ); 
listCtrlReport->AssignImageList(imageList, wxIMAGE_LIST_SMALL); 
// 插入 三 列 
wxListItem itemCol; 
itemCol.SetText(wxT("Column 1")); 
itemCol.SetImage(-1); 
listCtrlReport->InsertColumn(@, itemCol); 
listCtrlReport->SetColumnwidth(0, wxLIST_AUTOSIZE ); 
itemCol.SetText(wxT("Column 2")); 
itemCol.SetAlign(wxLIST_FORMAT_CENTRE); 
listCtrlReport->InsertColumn(1, itemCol); 
listCtrlReport->SetColumnwidth(1, wxLIST_AUTOSIZE ); 
itemCol.SetText(wxT("Column 3")); 
itemCol.SetAlign(wxLIST_FORMAT_RIGHT); 
listCtrlReport->InsertColumn(2, itemCol); 
listCtrlReport->SetColumnwidth(2, wxLIST_AUTOSIZE ); 
// 插入 10 个 子 项 
for ( int i = 0; i &lt; 10; i++ ) 


{ 
int imageIndex = 0; 
wxString buf; 
// 插入 一 个 子 项 , 字符 串 用 于 第 1 栏 ， 
// 图 片 索引 为 9 
buf.Printf(wxT("This is item %d"), i); 
listCtrlReport->InsertItem(i, buf, imageIndex); 
// 子 项 可 能 由 于 各 种 原因 (比如 :排序 ) 改 变 索 引 ， 
// 因此 将 现在 的 索引 保存 为 客户 区 数据 
listCtrlReport->SetItemData(i, i); 
// 为 第 2 栏 设置 一 个 文本 
buf.Printf(wxT("Col 1, item %d"), i); 
listCtrlReport->SetItem(i, 1, buf); 
// 为 第 三 栏 设 置 一 个 文本 
buf.Printf(wxT("Item %d in column 2"), i); 
listCtrlReport->SetItem(i, 2, buf); 

} 

虚 列 表 控 件 


通常 ,列表 控件 自己 保存 所 有 子 项 相关 的 文本 标签 ,图 片 以 及 其 它 可 见 属性 的 信息 ,对 于 小 量 数据 
来 说 ,这 是 不 成 问题 的 ,但 是 如 果 你 有 成 千 上 万 的 子 项 ,你 可 能 需要 实现 一 个 虚 的 列表 控件 . 虚 列 
表 控 件 由 应 用 程序 保存 子 项 的 数据 ,你 需要 重 载 它 的 三 个 虚 函 数 
OnGetltemLabel,OnGetltemlmage 和 OnGetltemAttr 列表 控件 会 在 需要 的 时 候 调 用 它们 .你 必 
须 调 用 SetltemCount 函 数 来 设置 当前 的 子 项 个 数 ,因为 你 将 不 会 实际 增加 任何 子 项 .你 还 可 以 义 
理 EVT_LIST_CACHE_HINT 事 件 以 便 在 某 一 部 分 子 项 即将 被 显示 直接 更 新 相关 的 内 部 数据 ,下 
面 是 重 载 三 个 画 数 的 一 个 简单 的 例子 : 


wxString MyListCtrl::OnGetItemText(long item, long column) const 
return wxString: :Format(wxT("Column %ld of item %ld"), column, item); 
int MyListCtr1l::OnGetItemImage(long WXUNUSED(item)) const 


// 全 部 的 子 项 都 返回 0 号 索引 的 图 片 
return 0; 


wxListItemAttr *MyListCtrl::OnGetItemAttr(long item) const 


// 这 个 成 员 是 内 部 使 用 用 来 为 每 一 个 子 项 保存 相关 属性 信息 
return item % 2 ? NULL : (wxListItemAttr *)&m_attr; 


下 面 演示 怎样 创建 一 个 虚 列 表 控 件 ,我 们 不 用 增加 任何 子 项 ,并 且 故 意 将 它 的 子 项 个 数 设 置 为 一 
个 略 显 硅 张 的 值 : 


virtualListCtrl = new MyListCtrl(parent, wxID_ANY, 
wxDefaultPosition, wxDefaultSize, wxLC_REPORT|wxLC_VIRTUAL); 
virtualListCtrl->SetImageList(imageListSmall, wxIMAGE_LIST_SMALL); 
virtualListCtrl->InsertColumn(0, wxT("First Column") ); 
virtualListCtrl->InsertColumn(1, wxT("Second Column") ); 
virtualListCtrl->SetColumnWidth(0, 150); 
virtualListCtrl->SetColumnWidth(1, 150); 
virtualListCtrl->SetItemCount (1000000) ; 


当 控 件 内 部 数据 改变 时 ,如 果子 项 总 数 改 变 , 你 需要 重新 设置 其 数目 ,然后 调用 
wxListCtrl::Refreshltem 或 者 wxListCtrl::Refreshltems 来 刷新 子 项 的 显示 . 


参考 samples/listctrl 目 录 中 的 完整 的 例子 . 


12.3 wxWizard 


使 用 向 导 是 将 一 堆 复 条 的 选项 变 成 一 系列 相对 简单 的 对 话 框 的 一 个 好 方法 . 它 通常 用 来 帮助 应 
用 程序 的 使 用 新 手 们 开始 使 用 某 个 特定 的 功能 ,比如 ,搜集 建立 新 工程 需要 的 信息 ,导出 数据 等 
等 .向 导 中 的 选项 通常 都 在 应 用 程序 别 的 用 户 界面 上 有 体现 ,但 是 提供 一 个 向 导 以 便 用 户 可 以 专 
注 于 那些 为 了 完成 某 个 任务 必须 要 设置 的 选项 . 


向 导 控 件 通常 在 一 个 窗口 内 提供 一 系列 的 类 似 对 笑 框 的 窗口 ,这 些 窗口 的 左边 都 拥有 一 副 图 片 
(可 以 是 一 祥 的 也 可 以 是 不 一 祥 的 ), 而 底部 则 通常 用 一 系列 导航 按钮, 随 着 用 户 的 选择 进入 预先 
设置 好 的 下 一 页 面 ,下 一 页 面 的 索引 是 随 用 户 的 选择 而 变化 的 ,因此 不 是 所 有 的 页 面 都 会 在 一 次 
向 导 执 行 过 程 中 全 部 显示 . 


当 标 准 的 向 导 导 航 按钮 被 按 下 时 ,将 会 产生 对 应 的 事件 ,向 导 类 或 者 其 派生 类 可 以 捕获 相应 的 事 
件 . 


要 显示 一 个 向 导 , 你 需要 先 创建 一 个 向 导 ( 或 者 其 派生 类 ), 然 后 创建 子 页 面 (作为 向 导 的 子 窗口 ). 


wxWizardPageSimple::Chain 画 数 将 其 和 一 个 向 导 绑 定 .或 者 ,如 果 你 需要 动态 调整 页 面 的 顺序 ， 
你 可 以 使 用 wxWizardPage 的 派生 类 , 重 载 其 GetPrev 和 GetNext 函 数 . 然后 将 每 一 个 页 面 增加 到 
GetPageAreaSizer 返 回 的 布局 控件 中 ,以 便 向 导 控 件 自动 将 自己 的 大 小 调整 到 最 大 页 面 的 大 小 . 


向 导 控 件 只 额外 定义 了 wxWIZARD_EX_HELPBUTTON 扩 展 类 型 ,以 便 在 标准 向 导 导 航 按钮 中 
增加 帮助 按钮 .注意 这 是 一 个 扩展 类 型 ,需要 在 Create 之 前 使 用 SetExtraStyle 来 进行 设置 . 


wxWizard 事 件 


WxWizard 产 生 wxWizardEvent 类 型 的 事件 ,如 下 表 所 示 , 这 些 事件 将 首先 被 发 送 到 当前 页 面 ,如 
果 页 面 没 有 定义 义理 函数 , 则 发 送 到 向 导 本 身 .除了 EVT_WIZARD_FINISHED 事 件 以 外 , 别 的 事 
件 都 可 以 调用 wxWizardEvent::GetPage 函 数 返 回 当前 页 面 . 


当 导 航 页 面 已 发 生 交 化 的 时 候 产 生 , 使 用 
wxWizardEvent::GetDirection At A a 
(true 为 向 前 ). 


当 导 航 页 面 即将 变化 的 时 候 产 生 , 这 个 事件 可 以 
EVT_WIZARD_PAGE_CHANGING(id， ”被 Veto 以 便 取 消 这 个 事件 .同样 可 以 使 用 
func) wxWizardEvent::GetDirection 判 断 方向 (true 为 
向 前 ). 


用 户 点 击 取消 按钮 的 时 候 产 生 , 这 个 事件 可 以 被 
Veto( 使 得 事件 导致 的 操作 无 效 ). 


EVT_WIZARD_HELP(id, func) 用 户 点 击 帮助 按钮 的 时 候 产 生 . 


用 户 点 击 完成 按钮 的 时 候 产 生 . 这 个 事件 产生 的 
时 间 是 在 向 导 对 话 框 刚刚 关闭 以 后 . 


EVT_WIZARD_PAGE_CHANGED(id, 
func) 


EVT_WIZARD_CANCEL(id, func) 


EVT_WIZARD_FINISHED(id, func) 


wxWizardAyAx j EEX 


GetPageAreaSizerNiZU0R OA > SEMA RHONDA RES KMS nes SH 
局 控件 中 ,或 者 将 某 一 个 可 以 通过 GetNext 函 数 访 问 到 其 它 所 有 页 面 的 ee 

以 便 向 导 控 件 可 以 知道 最 大 的 页 面 的 大 小 .如 果 你 没有 这 样 作 , 你 需要 在 显示 向 导 时 在 第 一 

面 显 示 之 前 调用 其 FitToPage 画 数 ,如 果 wxWizardPage::GetNext 不 肯 oe ae 

对 每 个 页 面 调用 FitToPageH RX. 


GetCurrentPage 疼 数 返回 当前 活动 的 页 面 ,如 果 RunWizard 函 数 还 没有 被 执行 则 返回 NULL. 


GetPageSize 当 前 设置 的 页 面 大 小 . SetPageSize 则 用 来 设置 所 有 页 面 使 用 的 页 面 大 小 ,不 过 最 
好 还 是 将 页 面 增 加 到 GetPageAreaSizer 布 局 控件 中 来 决定 页 面 大 小 比较 合适 . 


ee 传递 要 显示 的 第 一 个 页 面 作为 参数 ,以 便 业 向 导 置 于 执行 状态 .如 果 向 导 执行 成 
这 个 画 数 返回 True, 如 果 用 户 取 消 了 向 导 则 返回 False. 


可 以 用 SetBorder 范 数 设 置 向 导 边界 的 大 小 ,默认 为 0. 
wxWizard 使 用 举例 


我 们 来 看 看 wxWidgets 自 带 的 向 导 例子 . 它 包 含 四 个 页 面 ,如 下 图 所 示 ( 页 面 索 引 并 没有 显示 在 对 
话 框 上 ,这 样 说 只 是 为 了 清晰 ). 


Absolutely Useless Wizard 


This wizard doesn't help you 
to do anything at all 


The next pages will present you 
with more useless controls. 





Try checking the box below and 
then going back and cleaning it 
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wxWidgets 跨 平台 GUI 编程 


Absolutely Useless Wizard 


You need to check the checkbox 
below before going to the next page 





第 一 个 页 面 非常 简单 , 它 不 需要 实现 任何 派生 类 ,只 是 简单 的 创建 了 一 个 wxWizardPageSimple 
类 的 实例 ,然后 在 其 中 增加 了 一 个 静态 文本 标签 ,如 下 所 示 : 


#include "wx/wizard.h" 
wxWizard *wizard = new wxWizard(this, wxID_ANY, 
wxT("Absolutely Useless Wizard"), 
wxBitmap(wiztest_xpm), 
wxDefaultPosition, 
wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER) ; 
// 第 一 页 
wxWizardPageSimple *page1 = new wxWizardPageSimple(wizard) ; 
wxStaticText *text = new wxStaticText(page1, wxID_ANY, 
wxT("This wizard doesn't help you\nto do anything at all.\n") 
wxT("\n") 
wxT("The next pages will present you\nwith more useless controls."), 
wxPoint(5,5)); 


二 页 则 实现 了 milena pole ea , 重 载 了 其 GetPrev 和 GetNext 函 数 .前 者 总 是 返回 


第 
第 一 页 ,而 后 者 则 可 以 根据 用 户 的 选择 返回 下 一 页 或 者 最 后 一 页 .其 声明 和 实现 如 下 所 示 : 


12.3 wxWizard 


CD 
CD 
D 


// 演示 怎样 动态 改变 页 面 顺序 
// 第 二 页 
class wxCheckboxPage : public wxWizardPage 


public: 
wxCheckboxPage(wxWizard *parent, 
wxWizardPage *prev, 
wxWizardPage *next) 
: wxWizardPage(parent ) 


m_prev = prev; 
m_next next; 
wxBoxSizer *mainSizer = new wxBoxSizer (wxVERTICAL ); 
mainSizer ->Add( 
new wxStaticText(this, wxID_ANY, wxT("Try checking the box below and\n") 
wxT("then going back and clearing it")), 


0, // 不 需要 垂直 拉 什 
wxALL, 
5 // 边界 宽度 
); 
m_checkbox = new wxCheckBox(this, wxID_ANY, 
wxT("&Skip the next page")); 
mainSizer ->Add( 
m_checkbox, 
0, // 不 需要 垂直 拉 什 
wxALL, 
5 // 边界 宽度 
); 
SetSizer(mainSizer); 
mainSizer->Fit(this); 


} 

// BRwxwizardPageHR 

virtual wxwWizardPage *GetPrev() const { return m_prev; } 
virtual wxWizardPage *GetNext() const 


{ 
} 


private: 
wxWizardPage *m_prev, 
*m_next; 
wxCheckBox *m_checkbox; 


return m_checkbox->GetValue() ? m_next->GetNext() : m_next; 


}; 


第 三 页 实现 了 一 个 wxRadioboxPage 类 , 它 拦截 取消 向 导 和 页 面 改 变 事 件 .如 果 你 视图 在 这 个 页 
面 取 消 向 导 , 它 会 询问 你 是 否 真 的 要 取消 ,如 果 你 选择 否 , 则 它 将 使 用 事件 的 Veto 画 数 来 取消 这 个 
操作 .OnWizardPageChanging 画 数 则 拦截 所 有 的 页 面 改变 事件 ,并 根据 当前 单 选 框 的 选项 来 确 
定 是 否 人 允许 页 面 改 变 .在 实际 应 用 程序 中 ,你 可 以 使 用 这 种 技术 来 确保 向 导 在 某 一 页 的 时 候 必须 
填充 某 些 必须 的 域 ,否则 不 可 以 前 进 到 下 一 页 或 者 你 可 以 出 于 某 种 原因 阻止 用 户 返 回 以 前 的 页 
面 .代码 列举 如 下 : 


// 我 们 演示 了 另外 一 个 稍微 复 末 一 些 的 例子 , 通过 拦截 相应 事件 阻止 用 户 向 前 或 者 向 后 翻 页 
// 或 者 让 用 户 确 认 取消 操作 , 

// 第 三 页 

class wxRadioboxPage : public wxWizardPageSimple 


public: 
// 方向 枚 举 值 


enum 
{ 
Forward, Backward, Both, Neither 
wxRadioboxPage(wxWizard *parent) : wxWizardPageSimple(parent ) 


// 应 该 和 上 面 的 枚 举 值 对 应 


static wxString choices[] = { wxT("forward"), wxT("backward"), wxT("both"), wxT 


("neither") }; 


m_radio = new wxRadioBox(this, wxID_ANY, wxT("Allow to proceed:"), 
wxDefaultPosition, wxDefaultSize, 
WXSIZEOF(choices), choices, 
1, wxRA_SPECIFY_COLS); 
m_radio->SetSelection(Both) ; 
wxBoxSizer *mainSizer = new wxBoxSizer (wxVERTICAL) ; 
mainSizer ->Add( 
m_radio, 
O, // 不 伸缩 
wxALL, 
5 // 边界 
); 
SetSizer(mainSizer); 
mainSizer->Fit(this); 


} 
// 事件 处 理 画 数 
void OnWizardCancel(wxWizardEvent& event) 


{ 
if ( wxMessageBox(wxT("Do you really want to cancel?"), wxT("Question"), 
wxICON_QUESTION | wxYES_NO, this) != wxYES ) 
// 不 确认 , 取消 
event .Veto( ); 
} 
void OnWizardPageChanging(wxWizardEvent& event) 
{ 
int sel = m_radio->GetSelection(); 
if ( sel == Both ) 
return; 
if ( event.GetDirection() && sel == Forward ) 
return; 
if ( !event.GetDirection() && sel == Backward ) 
return; 
wxMessageBox(wxT("You can't go there"), wxT("Not allowed"), 
wxICON_WARNING | wxOK, this); 
event .Veto(); 
aa 
private: 


wxRadioBox *m_radio; 
DECLARE_EVENT_TABLE( ) 
}; 


SS | 


A nthe — A ,wxValidationPage, aa T Æ &transferDataFromWindoweN A LUE xt B xe 
框 控件 进行 数据 校 验 的 方法 .transferDataFromWindow 在 无 论 向 前 或 者 向 后 按钮 被 点 击 的 时 候 
都 会 被 调用 ,而 且 如 果 这 个 画 数 返回 失败 ,将 会 取消 向 前 或 者 向 后 操作 .和 所 有 的 对 话 框 用 法 一 


样 ,你 可 以 不 必 重 载 transferDataFromWindow 郴 数 而 是 给 对 应 的 控件 设置 一 个 验证 器 .这 个 页 
面 还 演示 了 怎样 更 改作 为 向 导 构 造 画 数 的 一 个 参数 的 默认 的 左 图 片 .下 面 是 相关 的 代码 : 


// 第 四 页 

class wxValidationPage : public wxWizardPageSimple 

public: 
wxValidationPage(wxwWizard *parent) : wxWizardPageSimple(parent) 
{ 


m_bitmap = wxBitmap(wiztest2_xpm); 
m_checkbox = new wxCheckBox(this, wxID_ANY, 
wxT("&Check me") ); 
wxBoxSizer *mainSizer = new wxBoxSizer (wxVERTICAL ) ; 
mainSizer ->Add( 
new wxStaticText(this, wxID_ANY, 
wxT("You need to check the checkbox\n") 
wxT("below before going to the next page\n")), 
0, 
wXALL, 
5 
); 
mainSizer ->Add( 
m_checkbox, 
0, 
wXALL, 
5 
); 
SetSizer(mainSizer); 
mainSizer->Fit(this); 


virtual bool TransferDataFromwindow( ) 


{ 
if ( !m_checkbox->GetValue() ) 
{ 
wxMessageBox(wxT("Check the checkbox first!"), 
wxT("No way"), 
wxICON_WARNING | wxOK, this); 
return false; 
} 
return true; 
3} 
private: 


wxCheckBox *m_checkbox; 


}; 


下 面 的 代码 用 于 将 所 有 的 页 面 放 在 一 起 并 且 开 始 执 行 这 个 向 导 : 


void MyFrame: :OnRunWizard(wxCommandEvent& event) 


{ 
wxWizard *wizard = new wxWizard(this, wxID_ANY, 
wxT("Absolutely Useless Wizard"), 
wxBitmap(wiztest_xpm), 
wxDefaultPosition, 
wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER); 
// 向 导 页 面 既 可 以 是 一 个 预定 义 对 象 的 实例 
wxWizardPageSimple *page1 = new wxWizardPageSimple(wizard) ; 
wxStaticText *text = new wxStaticText(page1, wxID_ANY, 
wxT("This wizard doesn't help you\nto do anything at all.\n") 
wxT("\n") 
wxT("The next pages will present you\nwith more useless controls."), 
wxPoint(5,5) 
); 
// ..， 也 可 以 是 一 个 派生 类 的 实例 
wxRadioboxPage *page3 = new wxRadioboxPage(wizard) ; 
wxValidationPage *page4 = new wxValidationPage(wizard) ; 
// 一 种 方便 的 设置 页 面 顺序 的 方法 
wxWizardPageSimple: :Chain(page3, page4); 
// 另外 一 种 设置 页 面 顺序 的 方法 
wxCheckboxPage *page2 = new wxCheckboxPage(wizard，page1，page3) ; 
pagei->SetNext(page2); 
page3->SetPrev(page2); 
// 允许 向 导 设置 自 适 应 的 大 小 . 
wizard->GetPageAreaSizer ()->Add(page1); 
if ( wizard->RunWizard(page1) ) 
{ 
wxMessageBox(wxT("The wizard successfully completed"), 
wxT("That's all"), wxICON_INFORMATION | wxOK); 
} 
wizard->Destroy(); 
} 


当 向 导 被 完成 或 者 取消 的 时 候 ,MyFrame 拦 截 了 相关 的 事件 ,在 这 个 例子 中 ,只 是 简单 的 将 其 结 
果 显 示 在 frame 窗 口 的 状态 条 上 .当然 你 也 可 以 在 向 导 类 中 拦截 相应 的 事件 . 


完整 版 本 的 代码 可 以 在 附录 J," 代 码 列 表 " 或 者 随 书 光盘 的 examples/chap12 目 录 中 找到 . 


12.4 wxHtmlWindow 


wxWidgets 在 其 内 建 帮 助 系统 中 使 用 了 wxHtmlWindow 控 件 ,如 果 你 希望 你 的 程序 可 以 显示 格式 
化 文件 ,图 片 等 (比如 在 生成 报表 的 时 候 ), 你 可 以 使 用 这 个 控件 .这 个 控件 可 以 支持 标准 HTML 标 
记 的 一 个 子 集 , 包 括 表格 (但 是 不 支持 框架 ),GIF 动画, 高 亮 链接 显示 ,字体 显示 ,背景 色 , 列 表 , 居 中 
或 者 右 对 齐 ,水平 条 以 及 字符 编码 等 .虽然 它 不 支持 CSS, 你 还 是 可 以 通过 已 引 SY A A 
记 来 达到 同样 的 效果 .其 中 的 HTML 文 本 也 支持 拷贝 到 剪贴 板 以 及 从 剪贴 板 以 普通 文本 的 方式 
拷贝 回应 用 程序 . 


下 图 演示 了 自 带 的 samples/html/test 例 子 编译 运行 以 后 的 样子 : 


This is - - default text, now switching to 


center, now still ctr, now exiting 


exited. [link to down} 


Hello, this "is" default charset (helvetica, probably) and it is foie with one | E, Of course we can 
have as many color changes as we can, what about thes | 


There was a space above. 


This was a line. (BTU we are in fixed font / typewriter font right now :-) 
This is in BOLD face. This is /TALIC. This is EVERYTHING 


Right now, (> e nte re d R EAL BY B | g Text how do you like (space) 8? 
RIGHT: waa td toxt40, text 1, text +2, text+3, text+4 


we are right now 
we are center now 


we are left now. > 
iClunadev|wewindows|sameles|hiniftest//Ciwx2dev/wawindows|sang 





和 一 个 完整 的 浏览 器 不 同 ,wxHtmlWindow 是 小 而 快 的 ,因此 你 可 以 在 你 的 程序 中 大 方 的 使 用 它 ， 
下 图 演示 了 在 一 个 关于 对 话 框 中 使 用 wxHtmlWindow 的 例子 : 


wxHTML Library Sample 0.2.0 


Copyright (C) 1999 Vaclav Slavik 


Vaclav Slavik 


Licenced under wxWindows Library Licence, Version 3. 





下 面 的 代码 用 来 创建 上 面 的 例子 ,在 这 个 例子 中 ,HTML 控 件 首先 使 自己 的 大 小 满足 其 内 部 的 
HTML 文 本 的 需要 ,然后 对 话 框 的 布局 控件 在 调整 自己 的 大 小 已 满足 HTML 控 件 的 需 


#include "wx/html/htmlwin.h" 

void MyFrame: :OnAbout (wxCommandEvent& WXUNUSED(event ) ) 

{ 
wxBoxSizer *topsizer; 
wxHtmlwWindow *html; 
wxDialog dlg(this, wxID_ANY, wxString(_("About"))); 
topsizer = new wxBoxSizer (wxVERTICAL); 
html = new wxHtmlWindow(&dlg, wxID_ANY, wxDefaultPosition, 

wxSize(380, 160), wxHW_SCROLLBAR_NEVER); 
html->SetBorders(0); 
html->LoadPage(wxT("data/about.htm")); 
// 让 HTML 控 件 的 大 小 满足 其 内 部 HTML 文 本 需要 的 大 小 
html->SetSize(html->GetInternalRepresentation()->GetWidth(), 
html->GetInternalRepresentation()->GetHeight()); 

topsizer->Add(html, 1, wxALL, 10); 
topsizer->Add(new wxStaticLine(&dlg, wxID_ANY), ©, wxEXPAND | wxLEFT | wxRIGHT, 10); 
wxButton *but = new wxButton(&dlg, wxID_OK, _("OK")); 
but->SetDefault(); 
topsizer->Add(but, ©, wxALL | wxALIGN_RIGHT, 15); 
dlg.SetSizer(topsizer) ; 
topsizer ->Fit(&dlg); 
d1lg.ShowModal(); 

} 


Le 
下 面 列 出 的 是 例子 中 的 HTML 文 本 : 


<html> 
<body bgcolor="#FFFFFF"> 
<table cellspacing=3 cellpadding=4 width="100%"> 
<tr> 
<td bgcolor="#101010"> 
<center> 
<font size=+2 color="#FFFFFF"><b><br>wxHTML Library Sample 0.2.0<br></b> 
</font> 
</center> 
</td> 
</tr> 
<tr> 
<td bgcolor="#73A183"> 
<b><font size=+1>Copyright (C) 1999 Vaclav Slavik</font></b><p> 
<font size=-1> 
<table cellpadding=0 cellspacing=0 width="100%"> 
<tr> 
<td width="65%"> 
Vaclav Slavik<p> 
</td> 
<td valign=top> 
<img src="logo.png"> 
</td> 
</tr> 
</table> 
<font size=1> 
Licenced under wxWindows Library Licence, Version 3. 
</font> 
</font> 
</td> 
</tr> 
</table> 
</body> 
</html> 


请 参考 第 4 章 ," 基 础 窗口 类 "中 ,"wxListBox 和 wxCheckListBox" 小 节 中 关于 wxHtmlListBox 的 内 
wxHtmlWindow 窗 口 类 型 

wxHW_SCROLLBAR_NEVER 不 要 显示 滚动 条 . 

wxHW_SCROLLBAR_AUTO 只 在 需要 的 时 候 显 示 滚 动 条 . 

wxHW_NO_SELECTION 用 户 不 可 以 选择 其 中 的 文本 (默认 可 以 ). 
wxHtmlWindow 成 员 画 数 


GetinternalRepresentation 函 数 返 回 最 顶层 的 wxHtmlContainerCell 控 件 , 使 用 它 的 GetWidth 和 
GetHeight 函 数 可 以 得 到 整个 HTML 区 域 的 大 致 大 小 . 


LoadFile 加 载 一 个 HTML 文 件 然后 显示 它 . LoadPage 则 可 以 传递 一 个 URL. 有 效 的 URL 包 括 : 


http://www.wxwindows.org/front.htm # 一 个 URL file:myapp.zip#zip:html/index.htm # 一 个 zip 
文件 中 特定 的 文件 


SetPage 则 直接 传递 要 显示 的 HTML 字 符 串 . 


OncCellClicked 本 数 在 有 鼠标 单 击 某 个 HTML 元 素 的 时 候 被 调用 . 它 的 参数 包括 wxHtmlCell 指 针 ， 
X 和 Y 座 标 , 一 个 wxMouseEvent 引 用 .其 默认 行为 为 :如 果 这 个 元 素 是 一 个 超 链 接 , 则 调用 
OnLinkClickedEa 2. 


OnLinkClicked NAHE 4 wxHtmIiLinkinfo # Œ, GRIF 4 ZA MA LoadPage ži a 4 
前 链接 .你 可 以 重 载 这 种 行为 ,比如 ,在 你 的 关于 对 话 框 中 ,你 可 以 在 用 户 单 击 某 个 链接 的 时 候 使 
用 默认 的 浏览 器 打开 你 的 主页 


它 可 以 重 载 的 画 数 包括 OnOpeningURL, 它 在 某 个 URL 正 被 打开 的 时 候 调 用 ， 
ee 当 鼠 标 移 过 某 个 HTML 元 素 的 时 候 被 调用 . 


ReadCustomization 和 WriteCustomization 函 数 则 用 来 保存 字体 和 边界 信息 ,它们 的 参数 包括 一 
个 wxConfig* 指 针 以 及 一 个 可 选 的 位 于 配置 中 的 路 径 . 


你 可 以 使 用 SelectAll,SelectLine 和 SelectWord 画 数 来 进行 文本 选择 ,SelectionToText 冯 当前 选 
择 区 域 以 纯 文 本 的 方式 返回 ,ToText 函 数 则 将 整 页 以 纯 文 本 的 方式 返回 . 


SetBorders 函 数 用 来 设置 HTML 周 围 的 边框 ,SetFonts 函 数 则 用 来 设置 字体 名 称 ,你 还 给 七 
个 预定 义 的 字体 大 小 指定 整数 类 型 点 单位 的 具体 大 小 . 


AppendToPage 画 数 在 当前 的 HTML 文 本 中 添加 内 容 并 且 刷 新 窗口 . 


你 可 以 编写 一 个 自 定义 的 wxHtmlFilter 以 用 来 读 取 特定 的 文件 ,你 可 以 使 用 AddFilter 函 数 将 其 在 
wxHtmlWindow 类 中 登记 .比如 ,你 可 以 写 一 个 自 定义 的 过 滤器 用 来 解密 并 显示 加 密 的 HTML 电 
子 杂 志 . 


GetOpenedAnchor, GetOpenedPage 和 GetOpenedPageTitle 画 数 用 来 返回 当前 网 页 的 一 些 相 
关 信 息 . 


wxHtmlWindow 有 自己 的 访问 历史 机 制 ,你 可 以 通过 HistoryBack, HistoryForward, 
HistoryCanBack, HistoryCanForward 和 HistoryClear 函 数 来 使 用 它 . 
在 网 页 中 集成 窗口 控件 


你 可 以 在 网 页 中 集成 你 自己 的 窗口 控件 ,甚至 包括 那些 你 自 定义 的 控件 ,如 下 图 所 示 .这 是 通过 制 
作 一 个 定制 的 标签 处 理 丽 数 来 实现 的 ,这 个 定制 的 标签 处 理 丽 数 用 来 处 理 某 些 特定 的 标签 并 相 
应 的 在 网 页 窗口 中 插入 自己 的 窗口. 


1a wxH TML Demo: Widgets demo; 


File Navigate 


{small one) 





a widget with floating width 


Here you can find multiple widgets at the same line: 
widget_1 widget_2 
here ...and here: 





上 图 演示 了 某 个 HTML 窗 口 的 一 部 分 ,是 由 下 面 的 网 页 产生 的 : 


<mybind name="(small one)" x=150 y=30> 


<hr> 
<mybind name="a widget with floating width" float=y x="50" y=50> 
<hr> 
Here you can find multiple widgets at the same line:<br> 
here 
<mybind name="widget_1" x="100" y=30> 
...and here: 


<mybind name="widget_2" x="150" y=30> 


用 于 实现 特定 的 HTML 标 记 mybind 的 代码 如 下 所 示 : 


#include "wx/html/m_templ.h" 
TAG_HANDLER_BEGIN(MYBIND, "MYBIND") 
TAG_HANDLER_PROC(tag) 

{ 


wxWindow *wnd; 

int ax, ay; 

int fl = 0; 

tag.ScanParam(wxT("X"), wxT("%i"), &ax); 

tag.ScanParam(wxT("Y"), wxT("%i"), &ay); 

if (tag.HasParam(wxT("FLOAT"))) fl = ax; 

wnd = new wxTextCtr1(m_WParser->GetWindow(), wxID_ANY, tag.GetParam(wxT("NAME")), 
wxPoint(0,0), wxSize(ax, ay), wxTE_MULTILINE); 

wnd->Show(true); 

m_WParser ->GetContainer()->InsertCell(new wxHtmlwidgetCell(wnd, f1)); 

return false; 


} 

TAG_HANDLER_END(MYBIND) 

TAGS_MODULE_BEGIN(MyBind) 
TAGS_MODULE_ADD(MYBIND) 

TAGS_MODULE_END(MyBind) 


这 种 技术 在 你 想 使 用 wxHtmlWindow 来 创建 整个 应 用 程序 界面 的 时 候 是 比较 有 用 的 ,你 可 以 用 
一 些 教 本 来 产生 HTML 文 件 以 响应 用 户 输入 ,就 象 一 个 网 页 表单 一 样 .另外 一 个 例子 是 当 你 需要 
搜集 用 户 的 注册 信息 的 时 候 , 你 可 以 提供 这 桩 一 个 界面 ,其 中 包含 文本 框 ,用 户 可 以 输入 相关 的 信 
息 然后 点 击 "注册 "按钮 以 便 将 他 输入 的 信息 发 送 到 你 的 组 织 .或 者 你 也 可 以 使 用 这 种 技术 来 给 
用 户 产 生 一 个 报告 ,报告 中 包含 一 些 复 选 框 ,以 便 可 以 可 以 针对 他 感 兴趣 的 内 容 进行 详细 查看 . 


关于 制作 自 定义 HTML 标 记 的 更 详细 的 内 容 ,请 参考 samples/html/widget 目 录 中 的 例子 ,或 者 
wxWidgets 参 考 手 册 . 


HTML 打 印 


通常 如 果 你 的 应 用 程序 中 使 用 了 wxHtmlWindow, 那 么 你 也 希望 能 够 打印 这 些 HTML 文 

件 .wxWidgets 提 供 了 一 个 wxHtmlEasyPrinting 类 来 用 一 种 简单 的 方法 打印 HTML 文 件 .你 需要 
作 的 是 创建 一 个 这 个 类 的 实例 ,然后 使 用 本 地 HTML 文 件 调 用 PreviewFile 和 PrintFile 函 数 .你 还 
可 以 调用 PageSetup 男 数 来 显示 打印 设置 对 话 框 ,使 用 GetPrintData 范 数 和 
GetPageSetupData 获 取 用 户 的 打印 设置 和 页 面 设置 .可 以 通过 SetHeader 和 SetFooter 本 数 定 
制 页 眉 和 页 脚 ,其 中 可 以 包含 预定 义 的 宏 @PAGENUM@( 当 前 页 码 ) 和 @PAGESCNT@( 总 页 
数 ). 


下 面 的 代码 取 自 samples/html/printing, 演 示 了 上 述 控 件 的 基本 使 用 方法 以 及 怎样 更 改 默 认 的 字 
体 : 


#include "wx/html/htmlwin.h" 
#include "wx/html/htmprint.h" 
MyFrame: :MyFrame(const wxString& title, 
const wxPoint& pos, const wxSize& size) 
wxFrame((wxFrame *)NULL, wxID_ANY, title, pos, size) 


{ 
m_Name = wxT("testfile.htm"); 
m_Prn = new wxHtmlEasyPrinting(_("Easy Printing Demo"), this); 
m_Prn->SetHeader(m_Name + wxT("(@PAGENUM@/@PAGESCNT@)&1t;hr&gt;"), 
wxPAGE_ALL); 
} 


MyFrame: :~MyFrame() 
delete m_Prn; 


void MyFrame: :OnPageSetup(wxCommandEvent& event) 


{ 
m_Prn->PageSetup(); 


void MyFrame: :OnPrint(wxCommandEvent& event) 


{ 


m_Prn->PrintFile(m_Name) ; 


void MyFrame: :OnPreview(wxCommandEvent& event) 


{ 


m_Prn->PreviewFile(m_Name) ; 


void MyFrame: :OnPrintSmall(wxCommandEvent& event) 


{ 
int fontsizes[] = { 4, 6, 8, 10, 12, 20, 24 }; 
m_Prn->SetFonts(wxEmptyString, wxEmptyString, fontsizes); 


void MyFrame: :OnPrintNormal(wxCommandEvent& event) 


{ 
m_Prn->SetFonts(wxEmptyString, wxEmptyString, 0); 


void MyFrame: :OnPrintHuge(wxCommandEvent& event) 


{ 
int fontsizes[] = { 20, 26, 28, 30, 32, 40, 44 }; 
m_Prn->SetFonts(wxEmptyString, wxEmptyString, fontsizes); 
} 


wxWidgets 自 带 的 samples/html 例 子 演示 了 上 述 所 有 的 知识 , 请 参考 . 


12.5 wxGrid 


wxGrid 是 一 个 功能 强大 的 但 是 又 稍微 有 一 些 复 末 的 窗口 类 用 来 显示 表格 类 型 的 数据 .你 还 可 以 
使 用 它 来 作为 一 个 包含 名 称 和 值 两 栏 的 属性 编辑 器 .或 者 是 通过 你 自己 的 代码 使 其 作为 一 个 一 
般 意义 上 的 表格 ,用 来 显示 一 个 数据 库 或 者 是 你 自己 应 用 程序 产生 的 特定 统计 数据 .在 某 种 情况 
你 ,你 还 可 以 用 它 来 代 蔡 列表 控件 中 的 报告 显示 模式 ,尤其 是 你 希望 在 某 一 个 特定 的 表格 位 置 显 
示 图 片 的 时 候 . 


网 格 控 件 拥 有 给 电子 表格 增加 行 标题 或 者 列 标题 的 能 力 ,用 户 可 以 通过 拖 搜 行 或 者 列 之 间 的 分 
割 线 来 改变 行列 的 大 小 ,选择 某 个 或 者 某 几 个 特定 的 表格 ,以 及 通过 点 击 某 一 格 对 其 中 的 值 进行 
编辑 .每 一 个 表格 都 有 自己 单独 的 属性 包括 字体 ,颜色 ,对 齐 方式 以 及 自己 的 泻 染 方 法 (用 于 绘制 
表格 ) 和 编辑 器 (用 于 编辑 表格 的 值 ). 你 也 可 以 制作 你 自己 的 泻 染 器 和 编辑 器 :参考 
include/wx/generic/grid.h 和 src/generic/grid.cpp 中 的 代码 .默认 情况 下 ,表格 将 使 用 简单 文本 泻 
染 器 和 编辑 器 .如 果 你 使 用 的 表格 拥有 不 同 于 预定 义 属 性 的 属性 ,你 可 以 创建 一 个 "属性 提供 

者 "对 象 ,以 便 在 程序 运行 期 动态 返回 需要 的 表格 的 属性 . 


你 也 可 以 使 用 包含 大 量 数据 的 虚 表 格 ,这 种 表格 的 数据 由 应 用 程序 自己 保管 ,不 过 不 是 通过 
wxGrid 类 .你 需要 使 用 wxGridTableBase 的 派生 类 并 且 重 载 其 中 的 GetValue, GetNumberRows 
和 GetNumberCols 画 数 .这 些 画 数 将 和 你 的 应 用 程序 数据 (也 许 是 数据 库 ) 打 交道 .然后 通过 
SetTable 画 数 给 网 格 控件 增加 一 份 数据 以 便 网 格 控件 可 以 进行 对 应 的 显示 ,这 种 更 深入 的 技巧 
在 你 的 wxWidgets 发 行 版 的 samples/grid 目 录 中 进行 了 演示 ,如 下 图 所 示 : 
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下 面 的 代码 创建 了 一 个 简单 的 8 行 10 列 的 表格 : 


#include "wx/grid.h" 

// 创建 一 个 wxGrid 对 象 

wxGrid* grid = new wxGrid(frame, wxID_ANY, 
wxDefaultPosition, wxSize(400, 300)); 

// 然后 调用 CreateGrid 设 置 表格 的 大 小 

grid->CreateGrid(8, 10); 

// 我 们 可 以 单独 给 某 一 行 或 者 某 一 列 设 置 象 素 单 位 的 宽度 或 高 度 . 

grid->SetRowSize(0, 60); 

grid->SetColSize(0, 120 ); 

// 然后 设置 表格 内 的 文本 内 容 

grid->SetCellValue(0, ©, wxT("wxGrid is good")); 

// 可 以 指定 某 些 表 格 是 只 读 的 

grid->SetCellValue(0, 3, wxT("This is read-only")); 

grid->SetReadOnly(0, 3); 

// 还 可 以 指定 某 个 表格 的 文本 颜色 

grid->SetCellValue(3, 3, wxT("green on grey")); 

grid->SetCellTextColour(3, 3, *wxGREEN); 

grid->SetCellBackgroundColour(3, 3, *wxLIGHT_GREY); 

// 还 可 以 指定 某 一 列 的 数据 采用 数字 的 格式 

// 这 里 我 们 设置 第 5 列 的 数字 格式 为 宽度 为 6, 小 数 点 后 保留 2 位 的 浮 点 数 

grid->SetColFormatFloat(5, 6, 2); 

grid->SetCellValue(0, 6, wxT("3.1415")); 

// 设置 网 格 的 大 小 为 可 以 显示 所 有 内 容 的 最 小 大 小 ， 

grid->Fit(); 

// 设置 其 父 窗口 的 客户 区 大 小 以 便 放 的 下 整个 网 格 . 

frame->SetClientSize(grid->GetSize()); 





wxGrid 系 统 中 的 类 


正如 你 已 经 理解 到 的 那样 ,WxGrid 类 是 许多 的 类 交互 作用 的 结果 .下 表 展 示 了 wxGrid 系 统 中 的 类 
以 及 它们 之 间 的 相互 关系 : 


wxGrid 


wxGridTableBase 


wxGridCellAttr 


wxGridCellRenderer 


wxGridCellEditor 


wxGridEvent 


wxGridRangeSelectEvent 
wxGridSizeEvent 


wxGridEditorCreatedEvent 


wxGridCellCoords 


wxGridCellCoordsArray 


wxGrid 的 事件 


最 主要 的 网 格 类 ,用 来 存放 别 的 用 于 管理 表格 , 行 和 列 等 的 其 
它 的 窗口 类 . 


这 个 类 允许 应 用 程序 想 虚 拟 的 网 格 提供 数据 .SetTable 函 数 
将 其 派生 类 的 一 个 实例 挂 载 入 网 格 类 . 


保存 用 于 浑 染 表格 的 属性 数据 .你 可 以 显 式 的 通过 类 似 
SetCellTextColour 这 样 的 函数 更 改 表格 的 属性 .你 也 可 以 通 
过 SetAttr 函 数 设 置 某 个 单独 的 表格 的 属性 或 者 是 通过 
SetRowAttr 和 SetColAttr 函 数 设置 某 一 列 或 者 某 一 行 的 属 
性 . 你 也 可 以 在 你 自 定 义 的 表格 类 中 通过 GetAttr 函 数 返回 
指定 表格 的 属性 . 


这 个 类 负责 对 表格 进行 渲染 和 绘制 .你 可 以 通过 改变 
wxGridCellAttr(5% 4 i it wxGrid::SetCellRenderer aX) 
对 应 的 类 的 实例 来 改变 某 个 表格 的 数据 格式 ,你 也 可 以 直接 
通过 WxGrid::SetDefaultRenderer 画 数 更 改 整 个 表格 的 显示 
方式 .这 是 一 个 虚 类 , 你 通常 需要 使 用 一 个 预定 义 的 派生 类 
或 者 自己 实现 一 个 派生 类 .预定 义 的 派生 类 包括 
wxGridCellStringRenderer, 
wxGridCellINumberRenderer,wxGridCellFloatRenderer 和 
wxGridCellBoolRenderer =. 


这 个 类 负责 实现 对 表格 数据 的 即时 编辑 功能 .这 个 虚 类 的 派 
生 类 的 实例 可 以 和 某 个 表格 , 某 行 , 某 列 甚至 整个 表格 绑 定 . 
比如 说 ,使 用 wxGrid::SetCellEditor 函 数 来 给 某 个 表格 中 的 
一 格 设置 编辑 器 . 预定 义 的 派生 类 包括 
wxGridCellTextEditor, wxGridCellFloatEditor, 
wxGridCellBoolEditor, wxGridCellNumberEditor4l 
wxGridCellChoiceEditor. 


这 个 类 包含 了 各 种 网 格 相关 事件 的 信息 ,比如 最 标 在 表格 上 
单 击 事件 ,表格 数据 改变 事件 ,表格 被 选中 事件 ,表格 编辑 器 
被 显示 或 者 隐藏 事件 等 . 


当 用 户 选择 一 组 表格 以 后 将 产生 这 个 事件 . 
当 某 一 行 或 者 某 一 列 的 大 小 发 生变 化 的 时 候 产 生 这 个 事件 . 
当 创 建 某 个 编辑 器 的 时 候 产生 这 个 事件 . 


这 个 类 用 来 代表 表格 中 的 某 一 格 . 使 用 GetRow 和 GetCol 函 
数 获取 具体 的 位 置 . 


这 是 一 个 wxGridCellCoords 类 型 的 数组 ,用 在 函数 
GetSelectedCell, GetSelectionBlockTopLeft 和 
GetSelectionBlockBottomRight 的 返回 值 中 . 


下 面 列 出 了 wxGrid 的 主要 的 事件 映射 宏 . 注 意 对 于 其 中 任何 一 个 EVTGRID... 宏 ,都 对 应 的 还 有 
一 个 EVTGRID_CMD... 宏 ,后 者 比 前 者 多 一 个 标识 符 参 数 ,可 以 用 来 避免 仅仅 出 于 这 个 原因 而 重 


新 定义 新 的 类 . 


EVT_GRID_CELL_LEFT_CLICK(func) 用 户 用 左 键 单 击 某 个 表格 . 





EVT_GRID_CELL_RIGHT_CLICK(func) 用 户 用 邮件 单 击 某 个 表格 . 
EVT_GRID_CELL_LEFT_DCLICK(func) 用 户 用 左 键 双击 某 个 表格 . 
EVT_GRID_CELL_RIGHT_DCLICK(func) 用 户 用 右键 双击 某 个 表格 . 
EVT_GRID_LABEL_LEFT_CLICK(func) 用 户 用 左 键 单 击 某 个 标题 . 
EVT_GRID_LABEL_RIGHT_CLICK(func) 用 户 用 右键 单 击 某 个 标题 . 
EVT_GRID_LABEL_LEFT_DCLICK(func) 用 户 用 左 键 双击 某 个 标题 . 
EVT_GRID_LABEL_RIGHT_DCLICK(func) 用 户 用 右键 双击 某 个 标题 . 
EVT_GRID_CELL CHANGE(func) 用 户 更 改 了 某 个 表格 的 数据 . 
EVT_GRID_SELECT_CELL(func) 用 户 选中 了 某 个 表格 . 
EVT_GRID_EDITOR_HIDDEN(func) 某 个 表格 的 编辑 器 已 隐藏 . 
EVT_GRID_EDITOR_SHOWN(func) 某 个 表格 的 编辑 器 已 显示 . 
EVT_GRID_COL_SIZE(func) 用 户 通过 拖 搜 改变 了 某 列 大 小 . 
EVT_GRID_ROW_SIZE(func) 用 户 通过 拖 搜 改 变 某 行 大 小 . 
EVT_GRID_RANGE_SELECT(func) 用 户 选 取 了 一 组 连续 的 单元 格 . 
EVT_GRID_EDITOR_CREATED(func) 某 个 单元 格 的 编辑 器 已 被 创建 . 
wxGrid 的 成 员 画 数 


下 面 按 功 能 列 出 了 上 比较 重要 的 wxGrid 的 成 员 函 数 .完整 的 成 员 事 数列 表 以 及 其 它 相 关 类 的 成 员 
KRMGSSRAFM. 


用 于 创建 ,删除 和 数据 交互 的 范 数 


AppendCols 和 AppendRows 用 来 在 最 下 边 或 者 最 右边 增加 行 或 者 列 ,或 者 你 还 可 以 使 用 
InsertCols 和 InsertRows 在 某 个 特定 位 置 插入 行 或 者 列 . 如 果 你 使 用 了 自 定义 的 表格 ,你 需要 重 
载 同名 的 这 些 画 数 . 


GetNumberCols 和 GetNumberRows 画 数 用 来 获取 和 网 格 绑 定 的 表格 数据 的 列 数 和 行 数 . 


CreateGrid 这 个 函数 用 来 以 指定 的 行 数 和 列 数 初始 化 网 格 的 数据 .你 应该 在 创建 网 格 实例 以 后 
马上 调用 这 个 函数 .这 个 画 数 会 为 网 格 创建 一 个 用 于 操作 简单 文本 数据 的 表格 ,表格 的 所 有 相关 
数据 都 将 保存 在 内 存 中 .如 果 你 的 应 用 程序 要 义理 更 负责 的 数据 类 型 或 者 更 复杂 的 依赖 关系 ,或 
者 说 要 义理 很 大 量 的 数据 ,你 可 以 实现 自己 的 表格 派生 类 ,然后 使 用 wxGrid::SetTable 画 数 将 其 
和 某 个 网 格 对 象 绑 定 . 


ClearGrid 函 数 清除 所 有 的 网 格 绑 定 表格 中 的 数据 并 且 刷 新 网 格 的 显示 .表格 本 身 并 不 会 被 释放 . 
如 果 你 使 用 了 自 定义 的 表格 类 ,记得 重 载 其 wxGridTableBase::Clear 成 员 函 数 以 实现 对 应 功能 
ClearSelection 画 数 用 来 去 选择 所 有 当前 选择 的 单元 格 . 


DeleteCols 和 DeleteRows 函 数 分 别 用 来 删除 列 和 行 


GetColLabelValue 函 数 返 回 某 个 指定 列 的 标签 .默认 的 表格 类 提供 的 列 标签 是 从 A, BZ, AA, 
AB@ZZ, AAA 傅 等 ,如 果 你 使 用 自 定 义 的 表格 类 ,你 可 以 重 定 义 
wxGridTableBase::GetColLabelValue 画 数 以 返回 相应 的 标签 . 类 似 的 , GetrowLabelValuets x 
用 来 返回 指定 行 的 标签 . 默认 的 行 标签 为 数字 .如 果 你 使 用 自 定 义 的 表格 ,可 以 重 载 其 
wxGridTableBase::GetRowLabelValue 画 数 来 提供 自 定义 的 默认 行 标 签 .你 还 可 以 使 用 
SetColLabelValue 和 SetRowLabelValue 函 数 来 指定 某 个 特定 行列 的 标签 . 


Co 来 返回 特定 单元 格 内 的 文本 .对 于 那些 使 用 简单 网 格 类 的 应 用 程序 ,你 可 以 使 用 
个 画 数 和 对 应 的 SetCellValue 函 数 来 操作 单元 格 内 的 文本 数据 .对 于 更 复杂 的 使 用 了 自 定义 
eg 个 函数 只 能 用 于 返回 那些 包含 文本 内 容 的 单元 格 的 内 容 . 


FRA KHL 
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BeginBatch#1EndBatch bx 2X AB IE © 471 A BY xt PAR xt RAVER ES ECB FR AT. 界面 更 新 将 
在 GetBatchCount 返 回 0 的 情况 下 更 新 ( 译 者 注 :BeginBatch 增 加 这 个 值 而 EndBatch 减 少 这 个 
值 ). 


EnableGridLines 设 置 允 许 或 者 禁止 绘制 网 格 线 . GridLinesEnabled 则 返回 当前 设置 


ForceRefresh 用 来 强制 立即 更 新 网 格 显示 . 你 应 该 使 用 这 个 函数 来 代替 wxWindow::Refresh 画 
数 . 


Fit 函 数 用 来 使 得 网 格 控件 将 自己 的 大 小 更 改 为 当前 行 数 和 列 数 所 要 求 的 最 小 大 小 . 


GetCellAlignment 返 回 指定 单元 格 在 垂直 和 水 平方 向 上 的 对 齐 方式 . GetColLabel 返 回 列 标签 的 
对 齐 方 式 , GetRowLabelAlignment 返 回 行 标签 的 对 齐 方 式 . GetDefaultCellAlignment 返 回 默认 
单元 格 的 对 齐 方 式 . 这 些 画 数 都 有 对 应 的 Set 开 始 的 设置 函数 . 水 平 对 齐 的 值 可 以 为 
wxALIGN_LEFT wxALIGN_CENTRE (wxALIGN_CENTER) 或 wxALIGN_RIGHT 垂直 对 齐 的 
枚 举 值 可 以 为 wxALIGN_TOP wxALIGN_CENTRE (wxALIGN_CENTER) 或 
wxALIGN_BOTTOM 之 一 . 


GetCellBackgroundColour 返 回 指定 单元 格 背 景 闫 色 . GetdefaultCellBackgroundColour 返 回 默 
认 单 元 格 背 景 冰 色 .GetLabelBackgroundColour 返 回 标签 表 景 产 色 .这 些 画 数 也 都 有 对 应 的 设置 
函数 . 


GetCellFont 函 数 返回 指定 单元 格 字 体 , GetdefaultCellFont 返 回 默认 单元 格 字 体 . GetLabelFont 
则 返回 标签 文本 字体 .这 些 函 数 也 都 有 对 应 的 设置 函数 . 


GetCellTextColour 返 回 指定 单元 格 的 文本 颜色 . GetdefaultCellTextColour 返 回 默认 单元 格 的 文 
本 颜色 ,GetLabelTextColour 则 返回 标签 文本 颜色 .这 些 辑 数 同样 拥有 对 应 的 设置 函数 


SetGridLineColour 和 GetGridLineColour 范 数 用 来 更 改 和 获取 网 格 线 的 颜色 . 


SetColAttr 和 SetRowAttr 用 来 设置 某 一 行 或 者 某 一 列 中 所 有 单元 格 的 属性 . 


SetColFormatBool, SetColFormatNumber, SetColFormatFloat 和 SetColFormatCustom 函 数 可 
以 用 来 更 改 某 一 列 的 单元 格 内 容 格 式 . 


和 wxGrid 大 小 相关 的 画 数 
下 面 的 这 些 函 数 的 参数 都 以 象 素 作为 单位 . 


AutoSize 辑 数 自 动 业 所有 单元 格 的 大 小 按照 其 内 容 进 行 调整 .对 应 的 还 有 AutoSizeColumn， 
AutoSizeColumns, AutoSizeRow 和 AutoSizeRows 男 数 . 


CellToRect 返 回 指定 单元 格 的 大 小 和 位 置 ,以 wxRect 表 示 . 


SetColMinimalWidth 和 SetRowMinimalHeight 用 来 设置 最 小 行 高 和 最 小 列 宽 , 对 应 的 获取 函数 
为 GetColMinimalWidth 和 GetrowMinimalHeight. 


下 面 这 些 函 数 用 来 获取 各 种 尺寸 大 小 : GetColLabelSize, GeTDefaultColLabelSize， 
GeTDefaultColSize, GetColSize, GetdefaultRowLabelSize, GeTRowSize, 
GeTDefaultRowSize 和 GeTRowLabelSize. 它们 都 有 对 应 的 设置 函数 . 


如 果 你 想 在 表格 周围 设置 额外 的 边 距 ,可 以 使 用 SetMargins 轴 数 . 


XToCol 和 YToRow 函 数 用 来 将 X 和 Y 座 标 转换 成 对 应 的 行 数 或 列 数 .要 找到 距离 其 右边 线 最 近 的 
对 应 于 X 座 标 值 的 列 号 ,使 用 XToEdgeOfCol 函 数 . 要 找到 具体 其 底 边 线 最 近 的 对 应 于 Y 座 标的 行 
5 {8 FAY ToEdgeOfRow NX. 


ib ALT Ar R 
下 面 的 这 些 函 数 用 于 控制 网 格 的 游标 和 选择 操作 


GetGridCursorCol 和 GetGridCursorRow 辑 数 返 回 当前 游标 所 处 的 行 号 和 列 号 .相应 的 设置 函数 
为 SetGridCursor. 


你 可 以 用 下 面 的 函数 以 每 次 一 格 的 方式 移动 游标 :MoveCursorDown, MoveCursorLeft, 
MoveCursorRight 和 MoveCursorUp. 如 果 希 望 在 移动 的 时 候 跳 到 第 一 个 非 空 单元 格 , 则 对 应 的 
使 用 MoveCursorDownBlock, MoveCursorLeftBlock, MoveCursorRightBlock 和 
MoveCursorUpBlock 画 数 . 


如 果 想 一 次 移动 一 页 ,可 以 使 用 MovePageDown 和 MovePageUp 郴 数 ,页 大 小 由 网 格 窗口 的 大 
小 决定 . 
GetSelectionMode 返 回 当 前 设置 的 选择 模式 , 它 的 值 为 下 列 之 一 : wxGrid::wxGridSelectCells 


(默认 模式 ,以 单元 格 为 单位 选择 ) wxGrid::wxGridSelectRows (以 行为 单位 选择 ), and 
wxGrid::wxGridSelectColumns (以 列 为 单位 进行 选择 ). xt AYR ENR % SetSelectionMode. 


GetSelectedCells 用 来 获取 当前 选中 的 单元 格 列表 , 它 的 返回 值 是 wxGridCellCoordsArray 类 型 ， 
其 中 包含 所 有 被 选中 的 单元 格 .GetSelectedCols 和 GetSelectedRows 则 返回 当前 选中 的 所 有 行 
和 列 .因为 用 户 可 以 选择 多 个 不 连续 的 单元 格 块 ,所 以 GetSelectionBlockTopLeft 和 
GetSelectionBlockBottomRight 返 回 的 也 是 一 个 wxGridCellCoordsArray 类 型 的 类 表 . 你 需要 自 
己 群 举 这 些 列 表 以 通 历 所 有 选中 的 单元 格 . 


lslInSelection 用 于 查询 指定 的 单元 格 是 否 被 选中 ,参数 为 行 号 列 号 或 者 wxGridCellCoords 类 型 . 
lIsSelection 则 返回 整个 网 格 是 否 有 任何 一 格 单元 格 被 选中 . 


使 用 SelectAll 选 择 整 个 表格 , SelectCol 函 数 用 于 选择 某 列 , SelectRow 辑 数 用 于 选择 某 行 . 
SelectBlock 用 于 选择 连续 的 一 块 区 域 ,参数 为 四 个 代表 左上 角 及 右 下 角 的 座 标的 整数 ,或 者 两 个 
wxGridCellCoords 类 型 的 参数 . 


其 它 wxGrid 函 数 


GetTable 函 数 返 回 网 格 用 于 保存 内 部 数据 的 绑 定 表格 对 象 . 如 果 你 使 用 了 CreateGrid 画 数 , 则 已 
经 创建 了 一 个 用 户 保存 简单 文本 数据 的 表格 ,或 者 ,你 已 经 使 用 SetTable 函 数 设 置 了 一 个 你 自 定 
义 的 表格 类 型 . 


GetCellEditor 和 SetCellEditor 用 来 获取 或 者 设置 指定 单元 格 绑 定 的 编辑 器 指针 . 
GetdefaultEditor 和 SetDefaultEditor 用 来 获取 和 设置 所 有 单元 格 使 用 的 默认 编辑 器 . 


GetCellRenderer 和 SetCellRenderer 获 取 或 者 设置 指定 单元 格 绑 定 的 泻 染 器 的 指针 . 
GeTDefaultRenderer 和 SetDefaultRenderer 用 来 获取 和 设置 所 有 单元 格 使 用 的 泻 染 器 . 


ShowCellEditControl 和 HideCellEditControl 用 来 在 相应 的 位 置 显 示 和 隐藏 当前 单元 格 指定 的 编 
辑 控件 .这 两 个 函数 通常 是 在 用 户 点 击 某 个 单元 格 来 编辑 单元 格 的 值 或 者 按 下 回 车 键 和 取消 键 
(或 者 单 击 另 外 一 个 窗口 ) 以 关闭 编辑 器 的 时 候 自 动 调用 的 . SaveEditControlValue 函 数 用 来 将 编 
辑 器 中 的 值 传输 到 单元 格 中 ,这 个 函数 在 关闭 网 格 或 者 从 网 格 获取 数据 的 时 候 你 可 以 考虑 调用 
以 便 网 格 的 值 反 应 最 新 编辑 的 值 . 


EnableCellEditControl 函 数 人 允许 或 者 禁止 对 网 格 数据 进行 编辑 . 这 个 函数 调用 的 时 候 ,网 格 类 闻 
会 产生 wxEVT_GRID_EDITOR_SHOWN 或 wxEVT_GRID_EDITOR_HIDDEN 事 件 . 
lsCellIEditControlEnabled 画 数 用 来 检测 是 否 当前 单元 格 可 以 被 编辑 . ISCurrentCellReadOnly 2! 
返回 是 否 当前 单元 格 是 只 读 的 . 


EnableDragColSize 人 允许 或 者 禁止 通过 拖 搜 更 改 列 宽 . EnableDragGridSize 人 允许 或 者 禁止 通过 
拖 搜 改变 单元 格 大 小 . EnableDragRowSize 人 允许 或 者 禁止 通过 拖 搜 改变 行 高 . 


EnableEditing 的 参数 如 果 为 false, 则 设置 整个 网 格 为 只 读 状 态 . 如 果 为 true, 则 网 格 恢复 到 默认 
状态 .在 默认 状态 ,单元 格 和 行 以 及 列 都 可 以 有 自己 的 是 否 可 编辑 标记 ,这 个 标记 可 以 通过 
WwWXxGridCellAttribute::SetReadOnly 改 变 , 针 对 单元 格 的 只 读 设置 可 以 直接 通过 
wxGridCellAttribute:: SetReadOnly WAX % .lsEditableN BURGE BE TAB ZS BT RA. 


你 也 可 以 通过 调用 SetReadOnly 范 数 改 变 某 个 单元 格 的 只 读 状 态 ,IsReadOnly 则 用 来 获取 这 个 


设置 . 


IsVisible 函 数 在 单元 格 部 分 或 者 全 部 可 见 的 时 候 返 回 true,MakeCellVisible 则 确保 某 个 单元 格 出 
于 可 见 区 域 . 


12.6 wxTaskBarlcon 


这 个 类 的 功能 是 在 系统 托盘 区 (Windows,Gnome 或 者 KDE) 或 者 停靠 区 (Mac OS X) 安 装 一 人 
标 .点 击 这 个 图 标 将 会 弹出 一 个 应 用 程序 提供 的 菜单 ,并 且 在 当 鳃 标 划 过 图 标的 时 候 会 显示 一 个 
可 选 的 工具 提示 .这 种 技术 提供 了 一 种 不 必 通 过 正规 的 用 户 界面 快速 访问 某 些 重要 功能 的 方法 . 
应 用 程序 可 以 通过 更 换 图 标 来 提供 某 些 状态 信息 ,比如 用 来 提示 电池 的 剩余 电量 或 者 windows 

系统 上 的 网 络 连接 提示 . 


下 图 演示 了 wxWidgets 自 带 的 samples/taskbar 例 子 在 windows 平 台 上 运行 时 的 样子 . 它 首先 显 
示 一 个 wxWidgets 的 图 标 , 当 电 标 移 过 这 个 图 标的 时 候 显示 "wxTaskBarlconSample." 工 具 提 示 ， 
右键 单 击 这 个 图 标 将 会 显示 一 个 菜单 ,菜单 有 三 个 选项 ,选择 设置 新 图 标 选 项 将 会 将 图 标 设置 为 
一 个 笑脸 ,并 且 把 工具 提示 更 改 为 一 个 新 的 文本 . 
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以 wxTaskBarlcon 方 式 驱 动 的 上 应用 程序 并 不 十 分 复杂 ,如 下 所 示 . 自 定义 的 类 型 MyTaskBarlcon 
重 载 了 wxTaskBarlcon 的 CreatePopupMenu 画 数 ,并 且 拦 截 了 左 键 双 击 事件 ,并 实现 了 三 个 菜单 


项 . 


class MyTaskBarIcon: public wxTaskBarIcon 


public: 
MyTaskBariIcon() {}; 
void OnLeftButtonDClick(wxTaskBarIconEvent&) ; 
void OnMenuRestore(wxCommandEvent&) ; 
void OnMenuExit (wxCommandEvent&) ; 
void OnMenuSetNewIcon(wxCommandEventé&) ; 
virtual wxMenu *CreatePopupMenu(); 
DECLARE_EVENT_TABLE( ) 
J; 
enum { 
PU_RESTORE = 10001, 
PU_NEW_ICON, 
PU_EXIT, 


BEGIN_EVENT_TABLE(MyTaskBarIcon, wxTaskBarIcon) 
EVT_MENU(PU_RESTORE, MyTaskBariIcon: :OnMenuRestore) 
EVT_MENU(PU_EXIT, MyTaskBariIcon: :OnMenuExit ) 
EVT_MENU(PU_NEW_ICON, MyTaskBariIcon: :OnMenuSetNewIcon) 
EVT_TASKBAR_LEFT_DCLICK (MyTaskBariIcon: :OnLeftButtonDClick) 

END_EVENT_TABLE( ) 

void MyTaskBarIcon: :OnMenuRestore(wxCommandEventé& ) 


{ 
dialog->Show(true); 


void MyTaskBarIcon: :OnMenuExit(wxCommandEvent& ) 
{ 


dialog->Close(true); 


void MyTaskBarIcon: :OnMenuSetNewIcon(wxCommandEvent&) 


{ 
wxIcon icon(smile_xpm); 
if (!SetIcon(icon, wxT("wxTaskBarIcon Sample - a different icon"))) 
wxMessageBox(wxT("Could not set new icon.")); 
} 
// BR 
wxMenu *MyTaskBarIcon: :CreatePopupMenu( ) 
{ 


wxMenu *menu = new wxMenu; 
menu->Append(PU_RESTORE, wxT("&Restore TBTest")); 
menu->Append(PU_NEW_ICON, wxT("&Set New Icon")); 
menu->Append(PU_EXIT, wxT("E&xit")); 

return menu; 


void MyTaskBarIcon: :OnLeftButtonDClick(wxTaskBarIconEvent&) 
{ 


} 


dialog->Show(true); 


下 面 的 代码 则 用 来 显示 一 个 对 话 框 并 且 安装 初始 化 图 标 . 


#include "wx/wx.h" 
#include "wx/taskbar.h" 
// 定义 一 个 新 的 应 用 程序 
class MyApp: public wxApp 


public: 
bool OnInit(void); 
J; 
class MyDialog: public wxDialog 
{ 
public: 


MyDialog(wxWindow* parent, const wxWindowID id, const wxString& title, 
const wxPoint& pos, const wxSize& size, const long windowStyle = 
wxDEFAULT_DIALOG_STYLE) ; 
~MyDialog(); 


void OnOK(wxCommandEvent& event); 
void OnExit(wxCommandEvent& event); 
void OnCloseWindow(wxCloseEvent& event); 
void Init(void) ; 

protected: 
MyTaskBarIcon *m_taskBariIcon; 

DECLARE_EVENT_TABLE( ) 

J; 

#include "../sample.xpm" 

#include "smile .xpm" 

MyDialog *dialog = NULL; 

IMPLEMENT_APP(MyApp) 

bool MyApp: :OnInit(void) 


// 创建 主 窗口 

dialog = new MyDialog(NULL, wxID_ANY, wxT("wxTaskBarIcon Test Dialog"), 
wxDefaultPosition, wxSize(365, 290)); 

dialog->Show(true); 

return true; 


} 
BEGIN_EVENT_TABLE(MyDialog, wxDialog) 
EVT_BUTTON(wxID_OK, MyDialog: :OnOK) 
EVT_BUTTON(wxID_EXIT, MyDialog: :OnExit) 
EVT_CLOSE(MyDialog: :OnCloseWindow) 
END_EVENT_TABLE( ) 
MyDialog: :MyDialog(wxWindow* parent, const wxWindowID id, const wxString& title, 
const wxPoint& pos, const wxSize& size, const long windowStyle): 
wxDialog(parent, id, title, pos, size, windowStyle) 


Init(); 


} 
MyDialog: :~MyDialog() 


delete m_taskBariIcon; 

ae MyDialog: :OnOK(wxCommandEvent& WXUNUSED(event ) ) 
Show( false); 

oe MyDialog: :OnExit (wxCommandEvent& WXUNUSED(event ) ) 
Close(true); 


} 
void MyDialog: :OnCloseWindow(wxCloseEvent& WXUNUSED(event ) ) 


{ 
Destroy(); 


void MyDialog: :Init(void) 


(void)new wxStaticText(this, wxID_ANY, wxT("Press 'Hide me' to hide me, Exit to quit.") 
wxPoint(10, 20)); 
(void)new wxStaticText(this, wxID_ANY, wxT("Double-click on the taskbar icon to show me 
again."), 
wxPoint(10, 40)); 
(void)new wxButton(this, wxID_EXIT, wxT("Exit"), wxPoint(185, 230), wxSize(80, 25)); 
(new wxButton(this, wxID_OK, wxT("Hide me"), wxPoint(100, 230), wxSize(80, 
25)))->SetDefault(); 
Centre(wxBOTH) ; 
m_taskBarIcon = new MyTaskBarIcon(); 
if (!m_taskBarIcon->SetIcon(wxIcon(sample_xpm), wxT("wxTaskBarIcon Sample") ) ) 
wxMessageBox(wxT("Could not set icon.")); 
} 


| 


wxTaskBarlcon 的 事件 


下 表 列 出 的 事件 宏 用 来 拦截 wxTaskBarlcon 相 关 的 事件 .注意 不 是 所 有 的 发 行 版 都 产生 这 些 事 
件 , 因 此 如 果 你 想 再 鼠标 点 击 的 时 候 弹 出 菜单 ,你 应 该 使 用 重 载 CreatePopupMenu 画 数 的 方法 . 
还 要 注意 wxTaskBarlconEvent 事 件 不 会 提供 任何 鼠标 指针 状态 信息 ,比如 鼠标 位 置 之 类 ， 


EVT_TASKBAR_MOVE(func) 鼠标 正在 图 标 上 移动 
EVT_TASKBAR_LEFT_DOWN(func) 左 键 按 下 . 
EVT_TASKBAR_LEFT_UP(func) 左 键 释放 . 
EVT_TASKBAR_RIGHT_DOWN(func) 右键 按 下 . 
EVT_TASKBAR_RIGHT_UP(func) 右键 释放 . 
EVT_TASKBAR_LEFT_DCLICK(func) 左 键 双击 . 
EVT_TASKBAR_RIGHT_DCLICK(func) 右键 双击 . 


wxTaskBarlcon 成 员 画 数 
wxTaskBarlcon 的 成 员 函 数 是 非常 简单 的 ,下 面 列 出 的 就 是 它 所 有 的 成 员 男 数 . 


CreatePopupMenu 是 一 个 虚 画 数 ,应 用 程序 已 经 重 载 这 个 男 数 以 返回 一 个 wxMenu 指 针 . 这 个 函 
数 在 对 应 的 wxEVT_TASKBAR_RIGHT_DOWN 事 件 中 被 调用 (在 Mac OS X 系 统 上 模拟 了 这 个 
事件 ). wxWidgets 也 会 在 菜单 被 关闭 的 时 候 自 动 释放 这 个 菜单 所 占用 的 内 存 . 


lslconlnstalled 返 回 是 否 Setlcon 已 经 被 成 功 调用 . 
IsOk 在 wxTaskBarlcon 对 象 已 经 被 成 功 初 始 化 的 时 候 返 回 True. 


PopupMenu 在 当前 位 置 显 示 一 个 菜单 .最 好 不 要 调用 这 个 函数 ,而 应 该 重 载 CreatePopupMenu 
函数 ,然后 让 wxWidgets 帮 你 显示 对 应 的 菜单 . 


Removelcon 移 除 前 一 次 使 用 Setlcon 函 数 设 置 的 图 


Setlcon 设 置 一 个 图 标 (WXlcon) 以 及 一 个 可 选 的 工具 提示 .这 个 函数 可 以 被 多 次 调用 . 


12.7 编写 目 定 义 的 控件 


这 一 小 节 , 我 们 来 介绍 一 下 怎样 创建 自 定义 的 控件 .实际 上 ,wxWidgets 并 不 具有 和 象 别 的 应 用 程序 
开发 平台 上 的 二 进 制 的 ,支持 鼠标 拖 入 应 用 程序 窗口 的 这 种 控件 .第 三 方 控件 通常 都 和 
wxWidgets 自 带 的 控件 比如 wxCalendarCtrl 和 wxGrid 一 样 ,是 通过 源 代码 的 方式 提供 的 .我 们 这 
里 用 的 "控件 "一 词 ,含义 是 比较 松散 的 ,你 不 一 定 非 要 从 "wxControl" 进 行 派生 ,比如 有 时 候 , 你 可 
能 更 愿意 从 wxScrolledWindow 产 生 派生 类 . 


制作 一 个 自 定义 的 控件 通常 需要 经 过 下 面 10 个 步 又 : 


1. 编写 类 声明 , 它 应 该 拥有 一 个 默认 构造 画 数 ,一 个 完整 构造 画 数 ,一 个 Create 函 数 用 于 两 步 创 
E, 最 好 还 有 一 个 Init 画 数 用 于 初始 化 内 部 数据 . 

2， 增 加 一 个 函数 DoGetBestSize, 这 个 男 数 应 该 根据 内 部 控件 的 情况 (比如 标签 尺寸 ) 返 回 该 控 
件 最 合适 的 大 小 . 

3， 如 果 已 有 的 事件 类 不 能 满足 需要 ,为 你 的 控件 增加 新 的 事件 类 . 比如 对 于 内 部 的 一 个 按钮 被 
按 下 的 事件 ,可 能 使 用 已 有 的 wxCommandEvent 就 可 以 了 ,但 是 更 复杂 的 控件 需要 更 复 灯 
的 事件 类 .并 且 如 果 你 增加 了 新 的 事件 类 ,也 应 改 增加 相应 的 事件 映射 宏 . 

4 编写 代码 在 你 的 新 控件 上 显示 信息 . 

5， 编 写 底 层 鼠 标 和 键盘 控制 代码 ,并 在 其 处 理 范 数 中 产生 你 自 定 义 的 新 的 事件 ,以 便 点 用 程序 
可 以 作出 相应 处 理 . 

6. 编写 默认 事件 义理 函数 ,以 便 控 件 可 以 处 理 那 些 标 准 事件 (比如 多 理 wxID_COPY 或 
wxID_UNDO 等 标准 命令 的 事件 ) 或 者 默认 的 用 户 界 面 更 新 事件 . 

7. 可 选 的 增加 一 个 验证 器 类 ,以 便 应 用 程序 可 以 用 它 使 得 数据 和 控件 之 间 的 传输 变 得 容易 ,并 
且 增 加 数据 校 验 功能 . 

8， 可 选 的 增加 一 个 资源 处 理 类 ,以 便 可 以 在 XRC 文 件 中 使 用 你 自 定义 的 控件 . 

9. 在 你 准 各 使 用 的 所 有 平台 上 测试 你 的 自 定义 控件 . 

10. 编写 文档 


我 们 来 举 一 个 简单 的 例子 ,这 个 例子 我 们 在 第 三 章 " 事 件 处 理 "中 便 经 使 用 过 ,当时 我 们 用 来 讨论 
自 定义 的 事件 : wxFontSelectorCtrl, 你 可 以 在 随 书 光 瘟 的 examples/chap03 中 找到 这 个 例子 .这 
个 类 提供 了 一 个 字体 预览 窗口 , 当 用 户 在 这 个 窗口 上 点 击 鼠 标的 时 候 会 弹出 一 个 标准 的 字体 选 
择 窗口 用 于 更 改 当 前 字体 .这 将 导致 一 个 新 的 事件 wxFontSelectorCtrlEvent, 应 用 程序 可 以 使 用 
EVT_FONT_SELECTION_CHANGED(id, func) 宏 来 拦截 这 个 事件 . 

这 个 控件 的 运行 效果 如 下 图 所 示 , 下 图 中 静态 文本 下 方 即 为 我 们 自 定义 的 控件 . 


Font [click to change}: 


abcdeABCDE 


自 定义 控件 的 类 声明 


下 面 的 代码 展示 了 自 定 义 控 件 wxFontSelectorCtrl 的 类 声明 .其 中 DoGetBestSize 只 简单 的 返回 
固定 值 200x40 象 素 ,如 果 构 造 画 数 中 没有 指定 大 小 ,我 们 会 默认 使 用 这 个 大 小 . 


ven 
* 一 个 显示 显示 字体 预览 的 自 定义 控件 . 
ay 


class wxFontSelectorCtrl: public wxControl 


DECLARE_DYNAMIC_CLASS(wxFontSelectorCtr1) 
DECLARE_EVENT_TABLE( ) 
public: 
// BK MISH 
wxFontSelectorCtrl() { Init(); } 
wxFontSelectorCtr1l(wxwindow* parent, wxWindowID id, 
const wxPoint& pos = wxDefaultPosition, 
const wxSize& size = wxDefaultSize, 
long style = wxSUNKEN_BORDER, 
const wxValidator& validator = wxDefaultValidator ) 


Init(); 
Create(parent, id, pos, size, style, validator); 


} 
// Create 
bool Create(wxWindow* parent, wxWindowID id, 
const wxPoint& pos = wxDefaultPosition, 
const wxSize& size = wxDefaultSize, 
long style = wxSUNKEN_BORDER, 
const wxValidator& validator = wxDefaultValidator); 
// 通用 初始 化 函数 
void Init() { m sampleText = wxT("abcdeABCDE"); } 
// BRAM 
wxSize DoGetBestSize() const { return wxSize(200, 40); } 
// 334 xo FBR Ry 
void OnPaint(wxPaintEvent& event); 
void OnMouseEvent (wxMouseEvent& event); 
// RERS 
void SetFontData(const wxFontData& fontData) { m_fontData = fontData; }; 
const wxFontData& GetFontData() const { return m_fontData; }; 
wxFontData& GetFontData() { return m_fontData; }; 
void SetSampleText(const wxString& sample); 
const wxString& GetSampleText() const { return m_sampleText; }; 


protected: 
wxFontData m_fontData; 
wxString m_sampleText; 
J; 


象 wxFontDialog 中 的 那样 ,我 们 使 用 wxFontData 类 型 来 保存 字体 数据 ,这 个 类 型 可 以 额外 的 保 
存 字体 颜色 信息 . 


这 个 控件 的 RTTI( 运 行 期 类 型 标识 ) 事 件 表 和 创建 画 数 的 代码 列举 如 下 : 


BEGIN_EVENT_TABLE(wxFontSelectorCtrl, wxControl) 
EVT_PAINT(wxFontSelectorCtrl: :OnPaint ) 
EVT_MOUSE_EVENTS(wxFontSelectorCtr1: :OnMouseEvent ) 

END_EVENT_TABLE( ) 

IMPLEMENT_DYNAMIC_CLASS(wxFontSelectorCtrl, wxControl) 

bool wxFontSelectorCtrl::Create(wxWindow* parent, wxWindowID id, 

const wxPoint& pos, const wxSize& size, long style, 
const wxValidator& validator) 


{ 

if (!wxControl::Create(parent, id, pos, size, style, validator)) 
return false; 
SetBackgroundColour (wxSystemSettings: :GetColour ( 
wxSYS_COLOUR_WINDOW) ); 

m_fontData.SetInitialFont(GetFont()); 
m_fontData.SetChosenFont(GetFont()); 
m_fontData.SetColour(GetForegroundColour()); 
// 这 个 画 数 告诉 相应 的 布局 控件 使 用 指定 的 最 佳 大 小 
SetBestFittingSize(size); 
return true; 

} 


xt FW AWSetBestFittingSizeh A sist ANA HeRAPBENA) RAE 
DoGetBestSize 函 数 返 回 的 大 小 作为 这 个 控件 的 最 小 尺寸 . 当 控 件 被 增加 到 一 个 布局 控件 中 时 ， 
根据 增加 画 数 的 参数 不 同 ,这 个 控件 的 尺寸 有 可 能 被 放大 . 


增加 DoGetBestSize 男 数 


实现 DoGetBestSize 函 数 的 目的 是 为 了 让 wxWidgets 可 以 以 此 作为 控件 的 最 小 尺寸 以 便 更 好 的 
布局 .如 果 你 提供 了 这 个 画 数 ,用 户 就 可 以 在 创建 控件 的 时 候 使 用 默认 的 大 小 (wxDefaultSize) 以 
便 控 件 自己 决定 自己 的 大 小 .在 这 里 我 们 只 是 选择 一 个 固定 值 200x40 象 素 ,虽然 是 固定 的 ,但 是 
是 合理 的 .当然 ,应 用 程序 可 以 通过 在 构造 画 数 中 传递 不 同 的 大 小 来 履 盖 它 .类 似 按钮 或 者 标签 这 
样 的 控件 ,我 们 可 以 提供 一 个 合理 的 大 小 ,当然 ,你 的 控件 也 可 能 不 能 够 决定 自己 的 大 小 ,比如 一 
个 没有 子 窗 口 的 滚动 窗口 通常 无 法 知道 自己 最 合适 的 大 小 ,在 这 种 情况 下 ,你 可 以 不 理会 
wxWindow::DoGetBestSize. 在 这 种 情况 下 ,你 的 控件 大 小 将 取决 于 用 户 在 构造 画 数 中 指定 的 非 
默认 大 小 或 者 应 用 程序 需要 通过 一 个 布局 控件 来 自动 觉得 你 的 控件 的 大 小 . 


如 果 你 的 控件 包含 拥有 可 感知 大 小 的 子 窗口 ,你 可 以 通过 所 有 子 窗口 的 大 小 来 决定 你 自己 控件 
的 大 小 , 子 窗口 的 合适 大 小 可 以 通过 GetAdjustedBestSize 函 数 获得 .比如 如 果 你 的 控件 包含 水 
平平 铺 的 两 个 子 窗口 ,你 可 以 用 下 面 的 代码 来 实现 DoGetBestSize 函 数 : 


wxSize ContainerCtrl: :DoGetBestSize() const 
{ 
// 获取 子 窗口 的 最 佳 大 小 
wxSize sizei, size2; 
if ( m_windowOne ) 
size1 = m_windowOne->GetAdjustedBestSize(); 
if ( m_windowTwo ) 
size2 = m_windowTwo->GetAdjustedBestSize(); 
// 因为 子 窗口 是 水 平平 铺 的 , 因此 
// 通过 下 面 的 方法 计算 控件 的 最 佳 大 小 . 
wxSize bestSize; 
bestSize.x = size1.x + Size2.x; 
bestSize.y = wxMax(sizei.y, size2.y); 
return bestSize; 


定义 一 个 新 的 事件 类 


我 们 在 第 三 章 中 详细 介绍 了 怎样 创建 一 个 新 的 事件 类 (wxFontSelectorCtrIEvent) 及 其 事件 映射 
宏 (EVT_FONT_SELECTION_CHANGED). 使 用 这 个 控件 的 应 用 程序 可 能 并 不 需要 拦截 这 个 
事件 ,因为 可 以 直接 使 用 数据 传送 机 制 会 更 方便 . 不 过 在 一 个 更 复杂 的 例子 中 ,事件 类 可 以 提供 
特别 的 函数 ,以 便 上 应 用 程序 的 事件 处 理 画 数 可 以 从 事件 中 获取 更 有 用 的 信息 ,比如 在 这 个 例子 中 ， 
我 们 可 以 增加 wxFontSelectorCtrlEvent::GetFont 函 数 以 返回 用 户 当前 选择 的 字体 . 


显示 控件 信息 


我 们 的 自 定义 控件 使 用 一 个 简单 的 重 绘图 数 显示 控件 信息 (一 个 居中 放置 的 使 用 指定 字体 的 文 
本 ), 如 下 所 示 : 


void wxFontSelectorCtrl: :OnPaint(wxPaintEvent& event) 


wxPaintDC dc(this); 

wxRect rect = GetClientRect(); 

int topMargin = 2; 

int leftMargin = 2; 

dc.SetFont(m_fontData.GetChosenFont()); 

wxCoord width, height; 

dc.GetTextExtent(m_sampleText, & width, & height); 

int x = wxMax(leftMargin, ((rect.GetWidth() - width) / 2)) ; 
int y = wxMax(topMargin, ((rect.GetHeight() - height) / 2)) ; 
dc.SetBackgroundMode(wxTRANSPARENT ) ; 
dc.SetTextForeground(m_fontData.GetColour()); 
dc.DrawText(m_sampleText, x, y); 

dc.SetFont(wxNullFont); 


如 果 你 需要 绘制 标准 元 素 ,比如 分 割 窗 口 的 分 割 条 或 者 一 个 边框 ,你 可 以 考虑 使 用 
wxNativeRenderer 类 (更 多 信息 请 参考 使 用 手册 ). 


处 理 输 入 


我 们 的 控件 会 拦截 左 键 单 击 事件 来 显示 一 个 字体 对 话 框 ,如 果 用 户 选择 了 新 的 字体 , 则 一 个 新 的 
事件 会 使 用 ProcessEvent 豆 数 发 送 给 这 个 控件 .这 个 事件 可 以 被 wxFontSelectorCtrl 的 派生 类 处 
理 , 也 可 以 被 包含 我 们 自 定义 控件 的 对 话 框 或 者 窗口 处 理 . 


void wxFontSelectorCtrl: :OnMouseEvent (wxMouseEvent& event) 


if (event.LeftDown() ) 


{ 

// 获取 父 窗口 

wxWindow* parent = GetParent(); 

while (parent != NULL && 

!parent->IsKindOf(CLASSINFO(wxDialog)) && 
! parent ->IsKindOf(CLASSINFO(wxFrame) ) ) 

parent = parent->GetParent(); 

wxFontDialog dialog(parent, m_fontData); 

dialog.SetTitle(_("Please choose a font")); 

if (dialog.ShowModal() == wxID_OK) 

{ 
m_fontData = dialog.GetFontData(); 
m_fontData.SetInitialFont( 

dialog.GetFontData().GetChosenFont()); 
Refresh(); 
wxFontSelectorCtrlEvent event( 
wxEVT_COMMAND_FONT_SELECTION_CHANGED, GetId()); 

event .SetEventObject(this); 
GetEventHandler()->ProcessEvent(event); 

} 

} 


这 个 控件 没有 拦截 键盘 事件 ， we 击 相 同 的 动作 .你 也 
可 以 在 你 的 控件 上 绘制 一 个 虚线 框 来 表明 是 否 其 当前 拥有 焦点 ,这 可 以 通过 
wxWindow::FindFocus 本 数 判断 ,如 果 你 决定 这 样 作 ,你 就 需要 拦截 EVT_SET_FOCUS 和 
EVT_KILL_FOCUS 事 件 来 在 合式 的 时 候 进 行 窗口 刷新 . 


定义 默认 事件 处 理 画 数 


如 果 你 看 过 了 wxTextCtrl 的 实现 代码 ,比如 src/msw/textctrl.cpp 中 的 代码 ,你 就 会 发 现 一 些 标准 的 
标识 符 比如 wxID_COPYwxID_PASTE, wxID_UNDO 和 wxlD_REDO 以 及 用 户 界面 更 新 事件 
意味 着 如 果 你 的 应 用 程序 设置 了 将 事件 首先 交 给 活动 控件 处 理 (参考 第 

0 章 :" 优 化 你 的 程序 "), 这 些 标准 菜单 项 事件 或 者 工具 按钮 事件 将 会 ER R 
3 当然 我 们 自 定义 的 控件 还 没有 复杂 到 这 种 程度 ,不 过 你 还 是 可 以 通过 这 种 机 制 实现 撤消 / 重 做 
操作 以 及 剪贴 板 相 关 操 作 . 我 们 来 看 看 wxTextCtrl 的 例子 : 


BEGIN_EVENT_TABLE(wxTextCtrl, wxControl) 
EVT_MENU(wxID_COPY, wxTextCtrl::OnCopy) 
EVT_MENU(wxID_PASTE, wxTextCtr1::OnPaste) 
EVT_MENU(wxID_SELECTALL, wxTextCtrl::OnSelectAll) 
EVT_UPDATE_UI(wxID_COPY, wxTextCtrl: :OnUpdateCopy) 
EVT_UPDATE_UI(wxID_PASTE, wxTextCtrl: :OnUpdatePaste) 
EVT_UPDATE_UI(wxID_SELECTALL, wxTextCtrl: :OnUpdateSelectAll) 


END_EVENT_TABLE( ) 
void wxTextCtrl: :OnCopy(wxCommandEvent& event) 


Copy(); 

void wxTextCtrl: :OnPaste(wxCommandEvent& event) 
Paste(); 

void wxTextCtrl: :OnSelectAll(wxCommandEvent& event) 


SetSelection(-1, -1); 


a wxTextCtr1: :OnUpdateCopy(wxUpdateUIEvent& event) 
: event.Enable( CanCopy() ); 
a wxTextCtrl: :OnUpdatePaste(wxUpdateUIEvent& event) 
: event.Enable( CanPaste() ); 
ae wxTextCtr1: :OnUpdateSelectAll(wxUpdateUIEvent& event) 
: event.Enable( GetLastPosition() &gt; 0 ); 
} 
实现 验证 器 


正如 我 们 在 第 9 章 ," 创 建 自 定义 的 对 话 框 "中 看 到 的 那样 ,验证 器 是 数据 在 变量 和 控件 之 间 传 输 的 
一 种 很 方便 地 手段 . 当 你 创建 自 定义 控件 的 时 候 , 你 可 以 考虑 创建 一 个 特殊 的 验证 器 以 便 应 用 程 
序 可 以 使 用 它 来 和 你 的 控件 进行 数据 传输 . 


WwWxFontSelectorValidator 是 我 们 为 wxFontSelectorCtrl 控 件 事 件 的 验证 器 ,你 可 以 将 其 和 一 个 字 
体 指 针 和 颜色 指针 或 者 一 个 wxFontData 对 象 绑 定 .这 些 变量 通常 是 在 对 话 框 的 成 员 变 量 中 声明 
的 ,以 便 对 话 框 持续 跟踪 控件 改变 并 且 在 对 话 框 被 关闭 以 后 可 以 通过 其 成 员 返 回 相 应 的 值 .注意 

验证 器 的 使 用 方式 ,不 需要 使 用 new 画 数 创建 验证 器 ,SetValidator 函 数 将 创建 一 份 验 证 器 的 持 贝 
并 且 在 需要 的 时 候 自动 释放 它 . 如 下 所 示 : 


wxFontSelectorCtrl* fontcCtrl = 
new wxFontSelectorCtrl1( this, ID_FONTCTRL, 
wxDefaultPosition, wxSize(100, 40), wxSIMPLE_BORDER ); 

// 或 者 使 用 字体 指针 和 颜色 指针 作为 参数 

fontCtrl->SetValidator( wxFontSelectorValidator(& m_font, 
& m_fontColor) ); 

/ .. .或 者 使 用 wxFontData 指 针 作 为 参数 
fontCtrl->SetValidator( wxFontSelectorValidator(& m_fontData) ); 


m_font 和 m_fontColor 变 量 (或 者 m_fontData 变 量 ) 将 反应 用 户 对 字体 预览 控件 所 做 的 任何 改变 . 
数据 传输 在 控件 所 在 的 对 话 框 的 transferDataFromWindow 男 数 被 调用 的 时 候 发 生 (这 个 画 数 闻 
被 默认 的 wxID_OK 处 理 函 数 调用 ). 


实现 验证 器 必须 的 辑 数 包括 默认 构造 男 数 , 带 参 数 的 构造 画 数 ,一 个 Clone 函 数 用 于 复制 自 
己 .Validate 函 数 用 于 校 验 数据 并 在 数据 非法 的 时 候 显 示 相 关 信 息 .transferToWindow 和 
transferFromWindow 则 实现 具体 的 数据 传输 . 


下 面 列 出 了 wxFontSelectorValidator 的 声明 : 


aia 

* wxFontSelectorCtr lait 

Xh 
class wxFontSelectorValidator: public wxValidator 


{ 
DECLARE_DYNAMIC_CLASS(wxFontSelectorValidator ) 
public: 
// ye 
wxFontSelectorValidator(wxFontData *val = NULL); 
wxFontSelectorValidator(wxFont *fontVal, 
wxColour* colourVal = NULL); 
wxFontSelectorValidator(const wxFontSelectorValidator& val); 
// HAL 
~wxFontSelectorValidator(); 
// 复制 自己 
virtual wxObject *Clone() const 
{ return new wxFontSelectorValidator(*this); } 
// 拷贝 数据 到 变量 
bool Copy(const wxFontSelectorValidator& val); 
// 在 需要 校 验 的 时 候 被 调用 
// 此 画 数 应 该 弹出 错误 信息 
virtual bool Validate(wxWindow *parent); 
// 传输 数据 到 窗口 
virtual bool TransferToWindow(); 
// 传输 数据 到 变量 
virtual bool TransferFromWindow(); 
wxFontData* GetFontData() { return m_fontDataValue; } 
DECLARE_EVENT_TABLE( ) 


protected: 
wxFontData* m_fontDataValue; 
wxFont* m_fontValue; 
wxColour* m_colourValue; 


// 检测 是 否 验证 器 已 经 被 正确 设置 
bool CheckValidator() const; 
3; 


建议 阅读 fontctrl.cpp 文 件 中 相关 的 函数 实现 以 便 对 齐 有 进一步 的 了 解 . 
实现 资源 处 理 器 


如 果 你 希望 你 自 定义 的 控件 可 以 在 XRC 文 件 中 使 用 ,你 可 以 提供 一 个 对 应 的 资源 处 理 器 .我 们 在 
这 里 不 对 此 作 过 多 的 介绍 ,请 参考 第 9 章 ,介绍 XRC 体 系 时 候 的 相关 介绍 .同时 也 可 以 参考 
wxWidgets 发 行 目录 ee 已 经 的 实现 . 


你 的 资源 处 理 器 在 应 用 程序 中 登记 以 后 ,XRC 文 件 可 以 包含 你 的 自 定义 控件 了 ,它们 也 可 以 被 你 
的 应 用 程序 自动 加 载 .不 过 如 果 制 作 这 no 文件 也 称 为 一 个 麻烦 事 .因为 通常 对 话 框 设计 工 
具 都 不 支持 动态 加 载 自 定义 控件 .不 过 通过 DialogBlocks 的 简单 的 自 定义 控件 定义 机 制 ,你 可 以 


指定 你 的 自 定义 控件 的 名 称 和 属性 ,以 便 生成 正确 的 XRC 文 件 ,虽然 ,DialogBlocks 只 能 作 到 在 其 
设计 界面 上 显示 一 个 近似 的 图 形 以 代 蔡 你 的 自 定义 控件 . 


全 测控 件 显示 效果 


当 创 建 自 定义 控件 的 时 候 , 你 需要 给 wxWidgets 一 些 关 于 控件 外 观 的 小 提示 . 记 住 ,wxWidgets 总 
会 尽 可 能 的 使 用 系统 默认 的 颜色 和 字体 ,不 过 也 人 允许 应 用 程序 或 者 自 定义 控件 在 平台 允许 的 时 
候 自己 决定 这 些 属 性 .wxWidgets 也 会 让 应 用 程序 或 者 控件 自己 决定 是 否 这 些 属 性 应 该 被 其 子 
对 象 继承 .控制 这 些 属性 的 体系 确实 有 一 些 复杂 ,不 过 ,除非 要 大 量 定制 控件 的 颜色 (这 是 不 推荐 
的 ) 或 者 实现 完全 属于 自己 的 控件 ,程序 员 很 少 需要 关心 这 些 细节 . 


除非 显 式 指明 ,点 用 程序 通常 会 允许 子 窗口 (其 中 可 能 包含 你 自 定 义 的 控件 ) 继 承 它们 父 窗口 的 

前 景 颜色 和 字体 .然后 这 种 行 es SetOwnFont 函 数 设 置 字体 或 者 使 用 
SetOwnForegroundColour 画 数 设置 前 景 颜色 来 改变 .你 的 控件 也 可 以 通过 调用 
ShouldinheritColours 画 数 来 决定 是 否 要 继承 父 窗口 的 颜色 (wxControl 默 认 需 要 ,而 wxWindow 
则 默认 不 需要 ). 背 景 颜 色 通 常 不 需要 显 式 继承 ,你 的 控件 应 该 通过 不 绘制 不 需要 的 区 域 的 方法 来 
保持 和 它 的 父 窗口 一 致 的 背景 . 


为 了 实现 属性 继承 ,你 的 控件 应 该 在 构造 画 数 中 调用 InheritAttributes 函 数 , 依 平台 的 不 同 ,这 个 画 
数 通常 可 以 在 构造 画 数 调用 wxControl::Create 男 数 的 时 候 被 调用 . 


某 些 类 型 实现 了 静态 辑 数 GetClassDefaultAttributes, 这 个 画 数 返回 一 个 wxVisualAttributes 对 
象 ,包含 前 景色 ,背景 色 以 及 字体 设 定 .这 个 函数 包含 一 个 只 有 在 Mac OS X 平 台 上 才 有 意义 的 参 
数 wxWindowVariant. 这 个 函数 指定 的 相关 属性 被 用 在 类 似 GetBackgroundColour 这 样 的 范 数 
中 作为 应 用 未 指定 值 时 候 的 返回 值 .如 果 你 不 希望 默认 的 值 被 返回 ,你 可 以 在 你 的 控件 中 重新 实 
现 这 个 加 数 .同时 你 也 需要 重 载 GetDefaultAttributes 虚 函数 ,在 其 中 调用 
GetClassDefaultAttributes 函 数 以 便 人 允许 针对 某 个 特定 的 对 象 返 回 默 认 属 性 .如 果 你 的 控件 包含 
一 个 标准 控件 的 类 似 属 性 ,你 可 以 直接 使 用 它 , 如 下 所 示 : 


// BARA, 用 于 全 局 访问 
static wxVisualAttributes GetClassDefaultAttributes( 
wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL ) 
return wxListBox: :GetClassDefaultAttributes(variant); 


} 
// RRL, A xt RIEL iF iA) 
virtual wxVisualAttributes GetDefaultAttributes() const 


{ 
} 


wxVisualAttributes 的 结构 定义 如 下 : 


return GetClassDefaultAttributes(GetWindowVariant()); 


struct wxVisualAttributes 
{ 
// 内 部 标签 或 者 文本 使 用 的 字体 
wxFont font; 
// 前 景色 
Wee colFg; 
/ $36; 背景 不 为 纯色 背景 时 可 能 为 wxNuL1ColLour 
colBg; 


如 果 你 的 自 定义 控件 使 用 了 透明 背景 ,比如 说 , 它 是 一 个 类 似 静 态 文本 标签 的 控件 ,你 应 该 提供 一 
个 画 数 HasTransparentBackground 以 便 wxWidgets 了 解 这 个 情况 (目前 久 支 持 windows). 


最 后 需要 说 明 的 是 ,如 果 某 些 操 作 需 要 在 某 些 属 性 已 经 确定 或 者 需要 在 最 后 的 步 又 才 可 以 运行 
你 可 以 使 用 空间 时 间 来 作 这 种 处 理 ,在 第 17 章 ," 多 线程 编程 "的 "多 线程 替代 方案 "中 对 此 有 进 一 
步 的 描述 


一 个 更 复杂 一 点 的 例子 :wxThumbnailCtrl 


前 面 我 们 演示 的 例子 wxFontSelectorCtrl 是 一 个 非常 简单 的 例子 ,很 方便 我 们 逐一 介绍 自 定义 控 
件 的 一 些 基本 原则 ,比如 事件 ,验证 器 等 .然后 ,对 于 显示 以 及 处 理 输 入 方面 则 显得 有 些 不 足 . 在 随 
书 光 意 的 examples/chap12/thumbnail 目 录 中 演示 了 一 个 更 复 厅 的 例子 wxThumbnailCtrl, 这 个 
控件 用 来 显示 缩 略图 .你 可 以 在 任何 应 用 程序 中 使 用 它 来 显示 图 片 的 缩 略 图 .( 事 实 上 它 也 可 以 显 
示 一 些 别 的 缩 略 图 ,你 可 以 实现 自己 的 wxThumbnailltem 的 派生 类 以 便 使 其 可 以 支持 显示 某 种 
文件 类 型 的 缩 略图 ,比如 显示 那些 包含 图 片 的 文档 中 的 缩 略 图 ). 


下 图 演示 的 wxThumbnailBrowserDialog 对 话 框 使 用 了 wxGenericDirCtrl 控 件 ,这 个 控件 使 用 了 
wxThumbnailCtrl 控 件 .出 于 演示 的 目的 ,正在 显示 的 这 个 目录 放置 了 一 些 图 片 . 


Image Browser Dialog 
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这 个 控件 演示 了 下 面 的 一 些 主题 ,当然 列 出 的 并 不 是 全 部 : 





。 鼠标 输入 : 缩 略图 子 项 可 以 通过 单 击 鼠 标 左 键 进行 选择 或 者 通过 按 着 Ctrl 键 单 击 鼠 标 左 键 
进行 多 选 . 


。 ft BA: 缩 略 图 网 格 可 以 通过 键盘 导航 ,也 可 以 通过 方向 键 翻 页 , 子 项 可 以 通过 按 住 Shift 


键 进行 选择 . 
° pan 设置 和 丢失 和 焦点 将 导致 当前 的 活动 缩 略 图 的 显示 被 更 新 . 
。 优化 绘图 : 通过 wxBufferedPaintDC 以 及 仅 更 新 需要 更 新 的 区 域 的 方法 实现 无 闪烁 更 新 当 
前 显示 . 
© 滚动 窗口 : 这 个 控件 继承 自 wxScrolledWindow 窗 口 ,可 以 根据 子 项 的 数目 自动 调整 滚动 条 . 
自 定义 事件 : 在 选择 ,去 选择 以 及 右键 单 击 的 时 候 产 生 wxThumbnailEvent 类 型 的 事件 . 


了 灵活 处 理 ,wxThumbnailCtrl 并 不 会 自动 加 载 一 个 目录 中 所 有 的 图 片 ,而 是 需要 通过 下 面 的 
eg eer i a 


// 创建 一 个 多 选 的 缩 略图 控件 
wxThumbnailCtr1* imageBrowser = 
new wxThumbnailCtr1(parent, wxID_ANY, 
wxDefaultPosition, wxSize(300, 400), 
wxSUNKEN_BORDER | wxHSCROLL | wxVSCROLL | wxTH_TEXT_LABEL | 
wxTH_IMAGE_LABEL | wxTH_EXTENSION_LABEL | wxTH_MULTIPLE_SELECT); 
// 设置 一 个 漂亮 的 大 的 缩 略 图 大 小 
imageBrowser ->SetThumbnailImageSize(wxSize(200, 200)); 
// 在 填充 的 时 候 不 要 显示 
imageBrowser - >Freeze(); 
// 设置 一 些 高 对 比 的 颜色 
ma E Oa >SetUnselectedThumbnailBackgroundColour (*wxRED); 
imageBrowser ->SetSelectedThumbnailBackgroundColour ( *wxGREEN) ; 
// 从 'path' 路 笃 查 找 图 片 并 且 增 加 
wxDir dir; 
if (dir.Open(path) ) 


wxString filename; 
bool cont = dir.GetFirst(&filename, wxT("*.*"), wxDIR_FILES); 
while ( cont ) 


{ 
wxString file = path + wxFILE_SEP_PATH + filename; 
if (wxFileExists(file) && DetermineImageType(file) != -1) 
{ 
imageBrowser ->Append(new wxImageThumbnailItem(file)); 
} 
cont = dir.GetNext(&filename) ; 
} 


} 

// 按照 名 称 排序 

imageBrowser->Sort (wxTHUMBNAIL_SORT_NAME_DOWN) ; 
// 标记 和 选择 第 一 个 缩 略图 

imageBrowser ->Tag(0); 

imageBrowser ->Select(0); 

// 删除 第 二 个 缩 略图 

imageBrowser->Delete(1); 

// 显示 图 片 

imageBrowser ->Thaw(); 


如 果 你 完整 的 阅读 thumbnailctrl.h 和 thumbnail.cpp 中 的 代码 ,你 一 定 会 得 到 关于 自 定 义 控件 的 
足够 的 知识 .另外 ,你 也 可 以 在 你 的 应 用 程序 中 直接 使 用 wxThumbnailCtrl 控 件 ,不 要 客气 . 


第 十 二 和 章 小 结 


本 章 介 绍 了 一 些 复杂 一 点 的 可 视 控 件 ,这 些 控件 可 能 你 在 第 一 次 使 用 wxWidgets 的 时 候 并 不 会 
用 到 ,但 是 随 着 你 的 应用 程序 复杂 程序 的 增加 ,你 几乎 肯定 会 在 你 的 代码 中 使 用 它们 中 的 一 个 或 
者 多 个 .最 后 一 小 节 介绍 了 怎样 实现 自 定义 的 控件 ,结合 本 章 介 绍 的 这 些 控件 的 源 代码 ,你 可 以 获 
得 足够 多 这 方面 的 提示 . 


同时 ,你 可 以 考虑 参考 附录 D,"wxWidgets 提 供 的 其 它 特性 ", 里 面 介绍 了 更 多 wxWidgets 自 带 的 复 


接 下 来 ,我 们 将 介绍 wxWidgets 中 使 用 的 一 些 数据 结构 及 其 类 型 . 


第 十 三 章 数据 结构 类 


存储 和 义理 数据 是 所 有 应 用 程序 必须 的 一 环 .从 最 简单 的 用 于 保存 大 小 和 位 置信 息 的 类 ,到 复 杀 
的 数据 类 型 比如 链表 和 哈 希 表 等 ,wxWidgets 提 供 了 一 整套 可 选 的 数据 结构 类 .本 章 将 展示 很 多 
数据 结构 类 ,并 着 重 展示 每 种 数据 结构 类 最 常用 的 函数 及 方法 .对 于 那些 比较 少 用 到 的 数据 结构 
类 及 其 方法 ,请 参考 wxWidgets 的 相关 文档 . 


另外 ,这 本 书 将 不 会 涉及 这 些 数据 结构 的 内 部 实现 ,尽管 如 此 ,就 算 不 知道 其 内 部 是 怎样 实现 的 ， 
每 个 人 也 都 需要 知道 这 些 结构 应 该 怎样 被 使 用 . 


13.1 为 什么 没有 使 用 STL? 


首先 ,我 们 来 回答 一 个 关于 wxWidgets 的 数据 结构 类 问 的 最 多 的 一 个 问题 :为 什么 它们 不 采用 基 
于 STL( 标 准 模板 库 ) 的 实现 ?". 最 主要 的 原因 是 历史 原因 :wxWidgets 从 1992 年 就 存在 了 ,这 上 比 可 
以 稳定 而 可 靠 的 支持 跨 平 台 交 叉 编译 的 STL 库 要 早 很 久 .不 过 随 着 wxWidgets 的 发 展 , 它 的 许多 
数据 结构 类 已 经 拥有 了 一 个 和 标准 STL 非 常 相似 的 APl, 希 望 有 一 天 ,wxWidgets 中 的 某 些 数据 结 
构 类 可 以 实现 完全 的 STL 兼 容 . 


尽管 这 样 ,你 还 是 可 以 在 你 的 wxWidgets 应 用 程序 中 使 用 STL, 这 需要 你 将 setup.h 中 的 
wxXUSE_STL 置 为 1( 或 者 在 配置 wxWidgets 的 时 候 使 用 enable-stl 选 项 ), 以 便 使 得 wxString 和 别 
的 容器 类 使 用 等 价 的 STL 实 现 .不 过 需要 事先 声明 ,在 wxWidgets 中 人 允许 STL 将 加 大 wxWidgets 
库 的 大 小 ,并 且 将 延长 wxWidgets 的 编译 时 间 , 尤 其 在 使 用 GCC 的 时 候 更 加 明显 ， 


13.2 FFP X A 


TAFRFE XRRR EFR A A ER mA. wxWidgetshi tett T 6AB 
的 字符 串 类 :wxString, 无 论 在 wxWidgets 内 部 还 是 在 其 提供 的 API 接 口上 ,这 个 类 都 被 很 广泛 的 
使 用 .wxString 类 拥有 你 对 一 个 字符 串 类 期 待 的 所 有 的 操作 ,包括 :动态 内 存 管理 ,从 其 它 字符 串 
类 型 构建 ,赋值 操作 ,单个 字符 访问 ,字符 串 连 接 和 比较 , 子 字 符 串 获取 ,大 小 写 转 换 , 空 格 字符 的 修 
剪 和 补 齐 ,查找 和 替换 ,类 似 C 语 言 printf 的 操作 以 及 类 似 流 一 样 的 插入 函数 等 等 . 


除了 上 述 的 这 些 字 符 串 义理 常用 功能 ,wxString 还 支持 一 些 额外 的 特性 .wxString 完 美 支持 
Unicode, 包 括 ANSI 字 符 和 Unicode 的 互相 转换 ,这 个 特性 是 和 wxWidgets 的 编译 配置 无 关 的 .使 
用 wxString 还 使 得 你 的 代码 拥有 直接 将 字符 串 传递 给 库 画 数 以 及 直接 从 库 汞 数 返回 字符 串 的 能 
力 .另外 ,wxString 已 经 实现 了 90% 的 STL 中 的 std::string 类 的 函数 ,这 意味 着 对 STL 熟 悉 的 用 户 基 
本 上 不 需要 重新 学 习 wxString 的 使 用 方法 . 


使 用 wxString 


在 你 的 应 用 程序 中 使 用 wxString 类 型 是 非常 简单 而 直接 的 .将 你 程序 中 使 用 std::string 或 者 是 别 
的 你 习惯 的 字符 串 类 的 地 方 ,全 部 用 wxString 代 替 基 本 就 可 以 了 .要 注意 的 是 ,所 有 参数 中 使 用 字 
符 串 的 地 方 ,最 好 使 用 const wxString& 这 样 的 声明 (这 使 得 函数 内 部 对 于 字符 串 的 赋值 操作 由 于 
使 用 了 引用 记 数 器 技术 而 变 得 更 快速 ), 而 所 有 返回 值 中 使 用 的 字符 串 则 最 好 直接 使 用 wxString 
类 型 ,这 使 得 在 画 数 内 部 即使 返回 一 个 局 部 变量 也 是 安全 的 . 


C 和 C++ 的 程序 员 通 常 都 已 经 很 熟悉 字符 串 的 各 种 操作 了 ,因此 wxString 的 详细 的 API 参 考 就 不 
在 这 里 罗 味 了 ,请 参考 wxWidgets 的 相关 文档 . 


你 可 能 会 注意 到 wxString 的 好 多 男 数 具有 同样 的 功能 ,比如 Length,Len 和 Ilength 范 数 都 返回 这 个 
字符 串 的 长 度 .在 这 种 情况 下 ,你 最 好 使 用 标准 STL 兼 容 的 函数 形式 .这 会 让 你 的 代码 对 别 的 程序 
员 来 说 更 亲切 ,并 且 将 使 你 的 代码 更 容易 转换 为 别 的 不 使 用 wxWidgets 库 的 代码 ,你 甚至 可 以 直 
接 使 用 typedef 将 wxString 重 定义 为 std::string. 另 外 wxVWidgets 某 一 天 可 能 会 开始 使 用 标准 的 


std:: string, 因 此 这 种 作法 也 会 让 你 的 代码 更 容易 保持 前 向 兼容 .( 当 然 ,wxString 的 函数 也 会 保留 
以 保证 后 向 兼容 .) 


wxString, 字 符 以 及 字符 串 常量 


wxWidgets 定 义 了 一 个 wxChar 类 型 ,在 不 同 的 编译 选项 (ANSI 或 Unicode) 下 ,这 个 类 型 用 来 映射 
char 类 型 或 者 wchar_t 类 型 . 象 前 面 提 到 的 那样 ,你 不 必 使 用 单独 的 char 类 型 或 者 wchar t 类 

型 ,wxString 内 部 存储 数据 的 时 候 使 用 的 是 相应 的 C 类 型 .在 任何 时 候 ,如 果 你 需要 对 单个 字符 进 
行 操作 ,你 应 该 使 用 wxChar 类 型 ,这 将 使 得 你 的 代码 在 ANSI 版 本 和 Unicode 版 本 中 保持 一 致 ,而 
不 必 使 用 大 量 的 预定 义 宏 


如 果 wxWidgets 被 编译 成 Unicode 的 版 本 ,和 标准 字符 串 常 量 是 不 兼容 的 ,因为 标准 字符 串 常量 
无 论 在 哪 种 版 本 中 都 是 char* 类 型 .如 果 你 想 在 Unicode 版 本 中 直接 使 用 字符 串 常量 ,你 应该 使 用 
一 个 转 义 宏 L.wxWidgets 提 供 了 一 个 宏 wxT( 或 者 T) 来 封装 字符 串 常量 ,这 个 宏 在 ANSI 版 本 中 
被 定义 为 什么 事情 也 不 做 ,而 在 Unicode 版 本 中 则 用 来 封装 L 宏 ,因此 无 论 在 哪 种 版 本 中 ,你 都 可 
以 使 用 下 面 的 方法 使 用 字符 串 常量 : 


wxChar ch = wxT('*'); 
wxString s = wxT("Hello, world!"); 
wxChar* pChar = wxT("My string"); 
wxString s2 = pChar; 


关于 使 用 Unicode 版 本 的 更 详细 的 信息 ,请 参考 第 16 章 :" 编 写 国 际 化 应 用 程序 ". 
wxString 到 C 指 针 的 转换 基础 


为 有 时 候 你 需要 直接 以 C 类 型 访问 wxString 的 内 部 数据 进行 底层 操作 ,wxWidgets 提 供 了 几 种 
对 应 的 访问 方法 : 


。 mb_str 函 数 无 论 在 ANSI 版 本 还 是 Unicode 版 本 都 返回 一 个 const char 类 型 的 指针 const 
char, 如 果 是 Unicode 版 本 , 则 字符 串 首先 经 过 转换 ,转换 过 程 可 能 导致 数据 丢失 . 

。 WC_str 辑 数 无 论 在 ANSI 版 本 还 是 Unicode 版 本 都 返回 一 个 wchar_ 世 * 类 型 ,如 果 是 ANSI 版 本 ， 
则 字符 串 首先 被 转换 成 Unicode 版 本 然后 再 返回 . 

e Cc_str 则 返回 一 个 指向 内 部 数据 的 指针 (ANSI 版 本 为 const char 类 型 , Unicode 版 本 为 const 
wchar_t 类 型 ). 不 进行 任何 转换 . 


你 可 以 使 用 c_str 函 数 的 特性 实现 wxString 和 std::string 之 间 的 转换 ,如 下 所 示 : 


std::string stri = wxT("hello"); 
wxString str2 = stri.c_str(); 
std::string str3 = str2.c_str(); 


使 用 wxString 经 常 遇 到 的 一 个 陷 井 是 过 度 使 用 对 const char* 类 型 的 隐 式 的 类 型 强制 转换 .我 们 
建议 你 在 任何 需要 使 用 这 种 转换 的 时 候 , 显 式 使 用 c_str 来 指明 这 种 转换 ,下 面 的 代码 演示 了 两 个 
常见 的 错误 : 

// SERS AMSA BH AKG HA, 然后 将 其 打印 在 屏幕 上 


// 并 且 返 回转 换 以 后 的 值 (这 是 一 个 充满 bug 的 代码 ) 
const char *SayHELLO(const wxString& input) 


wxString output = input.Upper(); 
printf("Hello, %s!\n", output); 
return output; 


} 


上 面 这 四 行 代 码 有 两 个 危险 的 缺陷 ,第 一 个 是 对 printf 函 数 的 调用 .在 类 似 puts 这 样 的 函数 中 , 隐 
式 的 类 型 强制 转换 是 没有 问题 的 ,因为 puts 声 明 其 参数 为 const char* 类 型 ,但 是 对 于 printf 函 数 , 它 
的 参数 采用 的 是 可 变 参 数 类 型 ,这 意味 着 上 述 printf 代 码 的 执行 结果 可 能 是 任何 一 个 种 结果 (包括 


正确 打印 出 期 待 结果 ), 不 过 最 常见 的 一 种 结果 是 程序 异常 退出 ,因此 ,应 该 使 用 下 面 的 代码 代 蔡 
上 面 的 printf 语 句 : 


printf(wxT("Hello, %s!\n"), output.c_str()); 
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const char* 类 型 ,这 样 的 代码 编译 是 没有 问题 的 ,但 是 它 返 回 的 将 是 一 个 局 部 变量 的 内 部 指针 ,而 
这 个 局 部 变量 在 图 数 返回 以 后 就 很 快 被 释放 了 ,因此 返回 的 指针 将 变 成 一 个 无 效 指针 .解决 的 方 
法 很 简单 ,应 该 将 返回 类 型 更 改 为 WxString 类 型 ,下 面 列 出 了 修改 了 以 后 的 代码 : 
// 这 段 代码 将 输入 的 字符 串 转换 为 大 写 函 数 , 然后 将 其 打印 在 屏幕 上 
// 并 且 返 回转 换 以 后 的 值 (这 是 正确 的 代码 ) 
wxString SayHELLO(const wxString& input) 
wxString output = input.Upper(); 
printf(wxT("Hello, %s!\n"), output.c_str()); 


return output; 


} 


标准 C 的 字符 串 处 理 辑 数 


因为 大 多 数 的 应 用 程序 都 要 处 理 字符 串 , 因 此 标准 C 提 供 了 一 套 相应 的 函数 库 . 不 幸 的 是 ,它们 中 
的 一 部 分 是 有 缺陷 的 (比如 strncpy 画 数 有 时 候 不 会 添加 结束 符 NULL), 另 外 一 部 分 则 可 角 能 存在 组 
冲 区 渝 出 的 危险 .而 另 一 方面 ,一 些 很 有 用 的 函数 却 没 能 够 进入 标准 的 C 画 数 库 .这 些 都 是 为 什么 
wxWidgets 要 提供 自己 的 额外 的 全 局 静态 函数 的 原因 ,wxWidgets 的 一 些 静 态 画 数 视图 避免 这 
些 缺 陷 :wxlsEmpty 郴 数 增 加 了 对 字符 串 是 否 为 NULL 的 校 验 , 在 这 种 情况 下 也 返回 
True.wxStrlen 画 数 也 可 以 处 理 NULL 指 针 , 而 返回 0.wxStricmp 函 数 则 是 一 个 平台 相关 的 大 小 写 
敏感 宇 符 串 比较 画 数 , 它 在 某 些 平台 上 使 用 stricemp 函 数 而 在 另外 一 些 平台 上 则 使 用 strcasecmp 
BAK. 


"wx/string.h" 头 文件 中 定义 了 wxSnprintf 函 数 和 wxVsnprintf, 你 应 该 使 用 它们 代替 标准 的 sprintf 
画 数 以 避免 一 些 sprintf 茵 数 先 天 的 危险 . 带 "n" 的 范 数 使 用 了 snprintf 函 数 ,这 个 画 数 在 可 能 的 时 候 
对 缓冲 区 进行 大 小 检查 .你 还 可 以 使 用 wxString::Printf 而 不 必 担 心 遭 受 可 能 受到 的 针对 printf 的 
缓冲 区 浴 出 攻击 . 


和 数字 的 相互 转换 


应 用 程序 经 常 需要 实现 数字 和 字符 串 之 间 的 转换 ,比如 将 用 户 的 输入 转换 成 数字 或 者 将 计算 的 
结果 显示 在 用 户 街 面 上 . 


ToLong(long* val, int base=10) 范 数 可 以 将 字符 串 转 换 成 一 个 给 定 进 制 的 有 符号 整数 . 它 在 成 功 
的 时 候 返 回 True 并 将 结果 保存 在 val 中 ,如 果 返 回 值 是 False, 则 表明 字符 串 不 是 一 个 有 效 的 对 应 

的 进 制 的 数字 .指定 的 进 制 必须 是 2 到 36 的 整数 ,0 意味 着 根据 字符 串 的 前 导 符 决定 : 0x 开 头 的 字 

符 串 被 认为 是 16 进 制 的 , 0- 则 被 认为 是 8 进 制 的 , 其 它 情况 下 认为 是 10 进 制 的 . 


ToULong(unsigned long* val, int base=10) 的 工作 模式 和 ToLong 函 数 一 致 ,不 过 它 的 转换 结果 


ToDouble(double* val) 则 实现 字符 串 到 浮 点 数 的 转换 .返回 值 为 Bool 类 型 . 


Printf(const wxChar pszFormat, ...) 和 C 语 言 的 sprintf 琅 数 类 似 ,将 格式 化 的 文本 作为 自己 的 内 
容 .返回 值 为 填充 字符 串 的 长 度 . 


静态 函数 Format(const wxChar* pszFormat, .….) 则 将 格式 化 的 字符 串 作为 返回 值 .因此 你 可 以 使 
用 下 面 的 代码 : 


int n = 10; 
wxString s = "Some Stuff"; 
s += wxString: :Format(wxT("%d"),n ); 


操作 符 "<<" 可 以 用 来 在 wxString 中 添加 一 个 int,float 或 者 是 double 类 型 的 值 . 


wxString Tokenizer 


WwWxStringTokenizer 帮 助 你 将 一 个 字符 串 分 割 成 几 个 小 的 字符 串 , 它 被 用 类 代 蔡 和 扩展 标准 C 画 
数 strtok, 它 的 使 用 方法 是 :传递 一 个 字符 串 和 一 个 可 选 的 分 割 符 (默认 为 空白 符 ), 然 后 循环 调用 
GetNextToken KAE 2] HasMoreTokensik | False, 40 FFAA: 


wxStringTokenizer tkz(wxT("first:second: third: fourth"), wxT(":")); 
while ( tkz.HasMoreTokens() ) 


wxString token = tkz.GetNextToken(); 


// 义理 单个 字符 串 


默认 情况 下 ,wxStringTokenizer 对 于 全 空 字 符 串 的 处 理 和 strtok 的 处 理 相同 ,但 是 和 标准 函数 不 
同 的 是 ,如 果 分 割 符 为 非 空 字符 , 它 将 把 空白 部 分 也 作为 一 个 子 字 符 串 返回 .这 对 于 义理 那些 格式 
化 的 表格 数据 (每 一 行 的 列 数 相同 但 是 单元 格 数据 可 能 为 空 ) 是 比较 有 好 处 的 ,比如 使 用 tab 或 者 
逗号 作为 分 割 符 的 情况 . 


wxStringTokenizer 的 行为 还 受 最 后 一 个 参数 的 影响 ,相关 的 描述 如 下 : 


e WxTOKEN_DEFAULT: 如 前 所 述 的 默认 处 理 方式 ; 如 果 分 割 符 为 空白 字符 则 等 同 于 
wxTOKEN_STRTOK,& n] $E] FwxTOKEN_RET_EMPTY. 

e wxTOKEN_RET_EMPTY: 在 这 种 模式 ,空白 部 分 将 作为 一 个 子 字符 串 部 分 被 返回 , 例 
如 "a::b:" 如 果 用 ":" 分 割 则 返回 三 个 子 字符 串 a, "和 b. 

。 wxTOKEN_RET_EMPTY_ALL: 在 这 种 模式 下 ,最 后 的 空白 部 分 也 将 作为 一 个 子 字 符 串 返 
回 . et 0 
相同 ,最 后 一 个 则 为 一 个 ". 

e wxTOKEN_RET_DELIMS: 在 这 种 模式 下 ,分 割 符 也 作为 子 字符 串 的 一 部 分 (除了 最 后 一 个 

子 字符 串 , 它 是 没有 分 割 符 的 ), 其 它 方面 类 似 wxTOKEN_RET_EMPTY. 

wxTOKEN_STRTOK: 这 种 情况 下 , 子 字符 串 的 产生 结果 和 标准 strtok 画 数 完 全 相同 .空白 字 


符 串 将 不 作为 一 个 子 字符 串 . 
wxStringTokenizer 还 有 下 面 两 个 有 用 的 成 员 本 数 : 


e CountTokens 函 数 返 回 分 割 完 的 子 字 符 串 的 数目 . 
e GetPosition 返 回 某 个 位 置 的 子 字符 串 . 


wxRegEx 


WwWXxRegEx 类 用 来 实现 正则 表达 式 .这 个 类 支持 的 操作 包括 正则 表达 式 查 找 和 蔡 换 .其 实现 方式 有 
基于 系统 正则 表达 式 库 (比如 现代 的 类 Unix 系 统 以 及 Mac OSX 支 持 的 POSIX 标 准 正则 表达 式 
库 ) 或 者 基于 由 Henry Spencer 提供 的 wxWidgets 内 建 库 .POSIX 定 义 的 正则 表达 式 有 基础 和 扩 
展 两 套 版 本 .内 建 的 版 本 支持 这 两 种 模式 而 基于 系统 库 的 版 本 则 不 支持 扩展 模式 . 


即使 是 对 于 那些 支持 正则 表达 式 库 的 系统 ,wxWidgets 默 认 的 Unicode 版 本 也 采用 了 内 建 的 正则 
表达 式 版 本 ,ANSI 版 本 则 使 用 系统 提供 的 版 本 . 记 住 只 有 内 建 版 本 的 正则 表达 式 库 才能 完全 支持 
Unicode. 当 编译 wxWidgets 的 时 候 ,覆盖 这 种 默认 设置 是 被 允许 的 .如 果 在 使 用 系统 正则 表达 式 
库 的 Unicode 版 本 中 ,在 使 用 对 应 玉 数 的 之 前 ,表达 式 和 要 匹配 的 数据 都 将 被 转换 成 8-bit 编 码 的 
Unicode 方 式 . 


使 用 wxRegEx 的 方法 和 其 它 所 有 使 用 正则 表达 式 的 方法 没有 区 别 .因为 正则 表达 式 的 内 容 较 为 
罗 嗪 而 且 又 鉴于 正则 表达 式 的 只 在 特定 情况 下 使 用 ,请 参考 WxWidgets 手 册 中 的 相关 内 容 了 解 
具体 的 APl. 


13.3 wxArray 


wxWidgets 使 用 wxArray 提 供 了 一 种 动态 的 数组 结构 .和 C 语 言 的 数组 结构 类 似 , 对 于 其 数组 项 的 
访问 时 间 为 一 个 常量 .对 然 这 样 ,其 内 存 仍然 是 动态 分 配 的 , 换 名 话说 ,如 果 其 内 存 不 够 再 增加 子 
项 的 时 候 , 它 将 动态 分 配 内 存 .在 提前 分 配 内 存 的 前 提 下 ,其 增加 数组 项 的 时 间 也 大 体 上 是 一 个 常 
量 . wxArray 类 型 还 提供 了 边界 检查 的 功能 ,在 调试 版 本 中 ,越界 访问 将 会 导致 断言 错误 ,而 在 正 
式 版 本 中 ,越界 访问 将 不 会 出 现任 何 提示 ,而 这 种 访问 的 结果 可 能 会 是 一 个 随机 值 . 


数组 类 型 


wxWidgets 提 供 了 三 种 不 同类 型 的 数组 .它们 都 是 wxBaseArray 的 派生 类 ,在 它们 的 数值 类 型 未 
定义 之 前 是 不 能 直接 使 用 的 . 换 句 话说 ,你 必须 使 用 WX_DEFINE_ARRAY,， 
WX_DEFINE_SORTED_ARRAY 和 WX_DEFINE_OBJARRAY 宏 来 定义 一 个 它们 的 派生 类 才 
可 以 使 用 它们 .这 种 基 类 的 名 称 分 别 为 wxArray,wxSortedArray 和 wxObjArray, 但 是 你 应 该 有 这 
个 概念 :这 三 个 类 其 实 是 不 存在 的 ,并 没有 这 样 的 类 ,这 个 名 称 只 是 为 了 用 来 说 明 问 题 用 的 . 


wxArray 这 种 类 型 , 它 的 派生 类 可 以 用 来 存储 整数 类 型 以 及 指针 类 型 ,这 种 类 型 永远 不 会 将 它 的 
成 员 按照 对 象 来 对 待 ,也 就 是 说 :数组 中 的 元 素 ( 无 论 是 整数 还 是 指针 ) 从 数组 移 除 的 时 候 并 不 会 
被 释放 .还 应 该 提 到 的 是 :wxArray 类 型 的 成 员 函 数 都 是 内 联 函 数 ,因此 程序 的 大 小 和 运行 效率 完 
全 不 受 其 派生 类 个 数 的 影响 .这 种 类 型 最 大 的 限制 在 于 , 它 只 能 存储 整形 数据 ,比如 
bool,charintlong 和 它们 的 无 符号 变 体 或 者 任何 类 型 的 指针 .而 浮 点 行 或 者 double 型 的 数据 是 不 
可 以 用 wxArray 来 存储 的 . 


wxSortedArray 和 wxArray 比 较 ,区 别 在 于 , 当 你 需要 很 频繁 的 数组 进行 查找 操作 时 ,你 应 该 使 用 
前 者 . 它 需 要 你 定义 一 个 比较 画 数 ,通过 这 个 比较 辑 数 , 它 将 把 其 内 部 的 元 素 始 终 按 顺 序 排列 ,如 
果 你 拥有 大 量 数 据 并 且 需 要 频繁 查找 ,那么 使 用 它 性 能 比 使 用 wxArray 要 好 的 多 .其 它 方面 两 者 
拥有 同样 的 限制 ,wxSortedArray 也 只 能 存储 整形 数据 . 


WXxObjArray 类 则 将 其 内 部 存储 的 元 素 按照 对 象 来 对 待 . 它 知道 在 元 素 从 数组 中 移 除 的 时 候 释 放 
相应 的 内 存 ( 通 过 调用 其 析 构 函数 ), 并 且 使 用 用 于 拷贝 的 构造 画 数 实现 拷贝 .要 定义 一 个 这 种 类 
型 的 派生 对 象 需要 两 个 步骤 .首先 ,使 用 WX_DECLARE_OBJARRAY 宏 来 声明 一 个 
WXObjArray, 然 后 包含 其 实现 文件 <wx/arrimpl.cpp> 并 且 在 完整 声明 了 其 数据 元 素 对 象 的 地 方 
调用 WX_DEFINE_OBJARRAY 宏 . 读 起 来 有 些 绕 口 ,不 过 我 们 很 快 会 举 一 个 简单 的 例子 


wxArrayString 

wxArrayString 是 存储 wxString 类 型 的 一 个 很 经 济 有 效 的 类 , 它 拥 有 和 wxArray 类 完全 一 致 的 功 
能 . 它 占用 的 空间 也 要 比 直接 使 用 C 数 组 类 型 wxString[] 占 用 的 空间 要 小 的 多 (这 是 因为 它 使 用 了 
一 些 直 接 对 wxString 类 内 部 进行 操作 的 方法 ). 所 有 在 wxArray 中 可 以 使 用 的 函数 都 可 以 在 
wxArrayString 中 使 用 . 


这 个 类 使 用 上 也 和 其 它 类 差别 不 大 ,唯一 的 区 别 在 于 不 需要 象 别 的 类 那样 使 用 
WX_DEFINE_ARRAY 宏 ,而 可 以 直接 在 代码 中 使 用 . 当 一 个 wxString 实 例 被 插入 这 个 数组 

时 ,WXArrayString 将 创建 一 份 这 个 字符 串 的 拷贝 ,应 该 在 成 功 插 入 以 后 ,你 可 以 放心 的 释放 原来 
的 字符 串 .一 般 情 况 下 ,你 也 不 需要 关心 wxArrayString 的 内 存 分 配 问题 , 它 可 以 自己 释放 它 所 占 
用 的 所 有 的 内 存 . 


另外 注意 ltem, Last 和 操作 符 [ 返 回 的 只 是 引用 而 不 是 拷贝 ,因此 ,对 它们 返回 值 的 操作 将 导致 数 
组 内 部 数据 的 改变 ,如 下 所 示 : 


array.Last().MakeUpper(); 


对 应 的 也 有 一 个 wxSortedArrayString 对 象 ,这 个 对 象 中 的 字符 串 总 是 按照 子 母 顺 序 排序 的 .在 得 
到 对 应 字符 串 的 Index 时 ,wxSortedArrayString 使 用 二 进 制 搜索 方式 ,性 能 很 高 .因此 如 果 你 的 程 
序 中 插入 字符 串 的 操作 很 少 ,而 对 其 进行 搜索 的 操作 很 多 ,你 可 以 考虑 使 用 这 个 类 .需要 注意 的 是 
不 要 调用 这 个 类 的 Insert 和 和 Sort 函数 ,这 两 个 本 数 可 能 会 搅乱 wxSortedArrayString 的 内 部 排序 . 


数组 的 构造 , 析 构 和 内 存 管 理 


数组 对 象 也 是 通用 的 C++ 对 象 ,也 有 对 应 的 构造 和 赋值 操作 .拷贝 一 个 wxArray 对 象 意味 着 其 内 
部 元 素 的 拷贝 而 拷贝 一 个 wxObjArray 对 象 则 是 直接 拷贝 这 个 数组 的 子 项 .不 过 ,出 于 内 存 效率 
的 考虑 ,这 两 个 类 都 没有 虚 的 析 构 函数 .对 于 wxArray 来 说 这 并 不 是 很 重要 , 因为 其 析 构 函数 不 需 
要 作 什 么 太 多 的 事情 ,而 对 于 wxObjArray 来 说 ,绝对 不 要 通过 删除 一 个 指向 wxBaseArray 类 型 的 
指针 来 释放 相应 的 数组 ( 译 者 注 : 这 将 导致 对 应 的 析 构 本 数 不 锌 调 用 ), 并 且 也 永远 不 要 从 你 自己 
的 数组 类 再 派生 新 的 类 型 ( 译 者 注 :同样 的 原因 ,新 类 型 的 释放 将 导致 使 用 宏 定 义 的 类 型 的 析 构 画 
数 不 被 调用 ). 


数组 的 内 存 自 动 管理 机 制 也 是 很 简单 的 : 它 在 开始 的 时 候 会 预 分 配 一 块 小 的 内 存 (由 宏 
WX_ARRAY_DEFAULT_INITIAL_SIZE 指 定 ). 当 发 现 不 够 用 的 时 候 , 就 增加 当前 内 存 的 50%( 但 
是 不 超过 ARRAY_MAXSIZE_INCREMENT).Shrink 函 数 可 以 用 来 在 没有 新 数据 插入 的 时 候 释 
放 多 余 的 内 存 . 而 Alloc 函 数 可 以 在 你 知道 总 共 需 要 多 少 内 存 的 时 候 被 调用 以 便 数 组 对 象 不 那么 
频繁 的 进行 分 配 内 存 的 操作 . 


数组 示例 : 


下 面 的 例子 演示 了 使 用 数组 最 复 厅 的 情况 ,定义 和 使 用 针对 自 定义 类 型 的 wxObjArray 数 组 .使 用 
wxArray 的 基本 原则 和 例子 中 演示 的 是 相似 的 ,只 不 过 wxArray 类 永远 不 需要 和 自己 内 部 存储 的 
数据 发 生 什 么 关系 . 


// 我 们 自 定 义 的 数据 类 型 
class Customer 


public: 
int CustID; 
wxString CustName; 


J; 

// 这 一 部 分 的 代码 可 以 位 于 头 文件 或 者 源 文 件 ( .cpp ) 文 件 中 

// 用 于 声明 我 们 的 自 定义 数组 : 
WxX_DECLARE_OBJARRAY(Customer, CustomerArray); 

// 增加 下 面 语句 的 唯一 的 要 求 是 , 自 定义 的 Customer 类 型 已 经 完全 声明 
// (对 于 WX_DECLARE_0BJARRAY 来 说 ,前面 的 声明 已 经 足够 了 ) 
// 而 且 通 常 它 应 该 被 放 在 源 文件 中 而 不 是 头 文件 中 , 

#include &lt;wx/arrimpl.cpp&gt; 
WX_DEFINE_OBJARRAY(CustomerArray); 

// 用 于 排序 的 时 候 对 两 个 对 象 进行 比较 

int arraycompare(Customer** argi, Customer** arg2) 


return ((*arg1)->CustID &lt; (*arg2)->CustID); 


} 
// 数组 测试 例子 
void ArrayTest() 
{ 
// 定义 一 个 我 们 数组 的 实例 
CustomerArray MyArray; 
bool IsEmpty = MyArray.IsEmpty(); // will be true 
// 创建 一 些 自 定义 对 象 实例 
Customer CustA; 
CustA.CustID = 10; 
CustA.CustName = wxT("Bob"); 
Customer CustB; 
CustB.CustID = 20; 
CustB.CustName = wxT("Sally"); 
Customer* CustC = new Customer(); 
CustC->CustID = 5; 
CustC->CustName = wxT("Dmitri"); 
// 将 其 中 两 个 增加 到 数组 中 
MyArray.Add(CustA); 
MyArray.Add(CustB); 
// 将 最 后 一 个 插入 到 数组 的 任意 位 置 . 
// 数组 将 会 产生 一 个 自 定义 对 象 的 拷贝 
MyArray.Insert(*CustC, (size_t)0); 
int Count = MyArray.GetCount(); // will be 3 
// 如 果 找 不 到 将 返回 wxNOT_FOUND 
int Index = MyArray.Index(CustB); // will be 2 
// 依次 处 理 数 组 中 的 对 象 
for (unsigned int i = 0; i &lt; MyArray.GetCount(); i++) 
{ 














Customer Cust = MyArray[i]; // 或 者 使 用 MyArray.Item(i); 
// 进行 一 些 处 理 


} 

// 按照 自己 提供 的 比较 函数 进行 排序 
MyArray.Sort(arraycompare) ; 

// 移 除 但 不 释放 A 对 象 

Customer* pCustA = MyArray.Detach(1); 
// 如 果 使 用 Detach 画 数 , 我 们 需要 自己 释放 对 象 
delete pCustA; 

// $0218 ARemoveHR, 就 不 需要 了 
MyArray.RemoveAt (1); 

// Clear 画 数 也 不 需要 

MyArray.Clear(); 

// 数组 从 来 就 不 会 理会 我 们 自己 产生 的 C 对 象 , 要 自己 释放 它 
delete CustC; 


13.4 wxList 和 wxNode 


wxList 类 是 一 个 双向 链表 ,可 以 用 来 存储 任何 类 型 的 数据 .wxWidgets 需 要 你 显 式 的 定义 一 个 针 
对 某 种 数据 类 型 的 新 的 类 来 使 用 它 ,以 便 对 存储 于 其 中 的 数据 提供 足够 的 类 型 检查 .wxList 类 还 
允许 你 指定 一 个 索引 类 型 以 便 进 行 基本 的 查找 操作 (如 果 你 想 使 用 基于 结构 的 快速 随机 访问 ,请 
参考 下 一 节 的 wxHashMap 类 ). 


wxList 使 用 了 一 个 虚 类 wxNode. 当 你 定义 一 个 新 的 wxList 派 生 类 的 时 候 , 你 同时 定义 了 一 个 派生 
自 wxNodeBase 的 类 ,以 便 对 节点 提供 类 型 安全 检查 .节点 类 最 重要 的 函数 包 

括 :GetNext,GetPrevious 和 GetData. 它 们 的 功能 显而易见 ,分 别 为 :获取 下 一 个 子 项 ,获取 前 一 个 
子 项 以 及 获取 子 项 的 数据 . 


唯一 值得 说 明 的 是 wxList 的 删除 操作 ,默认 情况 下 ,从 链表 中 移 除 一 个 节点 并 不 会 导致 节点 内 部 
数据 的 释放 .你 需要 调用 DeleteContents 函 数 来 改变 这 种 默认 的 行为 ,设置 数据 随 着 节点 一 起 释 


放 . 如 果 你 想 清除 整个 链表 并 且 释 放 其 中 的 数据 ,你 应 该 先 调 用 DeleteContents, 参 数 为 True, 然 
Bia Clear. 


我 们 用 不 着 在 这 里 把 手册 的 内 容重 新 粘贴 一 通 . 我 们 将 举 一 个 简单 的 例子 来 演示 怎样 创建 你 自 
己 的 链表 类 型 .注意 WX_DECLARE_LIST 宏 通常 应 该 位 于 头 文件 中 ,而 WX_DEFINE_LIST 宏 通 
常 应 该 位 于 源 文件 中 . 


// 我 们 将 存储 于 链表 的 数据 类 型 


class Customer 


public: 
int CustID; 
wxString CustName; 


J; 

// 通常 应 该 位 于 头 文件 中 

WxX_DECLARE_LIST(Customer, CustomerList); 

// 下 面 的 定义 应 该 位 于 源 文件 中 , 并 且 通 常 位 于 所 有 Customer 声 明之 后 
#include &lt;wx/listimpl.cpp&gt; 
WX_DEFINE_LIST(CustomerList) ; 

// 用 于 排序 的 比较 函数 

int listcompare(const Customer** argi, const Customer** arg2) 


return ((*arg1)->CustID &lt; (*arg2)->CustID); 


} 
// 链表 操作 举例 
void ListTest() 
{ 
// 定义 一 个 我 们 自 定义 链表 的 实例 
CustomerList* MyList = new CustomerList(); 
bool IsEmpty = MyList->IsEmpty(); // will be true 
// 创建 一 些 自 定义 对 象 实例 
Customer* CustA = new Customer; 
CustA->CustID = 10; 
CustA->CustName = wxT("Bob"); 
Customer* CustB = new Customer; 
CustB->CustID = 20; 
CustB->CustName = wxT("Sally"); 
Customer* CustC = new Customer; 
CustC->CustID = 5; 
CustC->CustName = 
// 将 其 增加 到 链表 中 
MyList ->Append(CustA); 
MyList ->Append(CustB); 
// 实现 随机 插入 
MyList->Insert((size_t)0, CustC); 
int Count = MyList->GetCount(); // will be 3 
// 如 果 找 不 到 , 返回 wxNOT_FOUND 
int index = MyList->IndexOf(CustB); // will be 2 
// 自 定义 的 节点 里 包含 了 我 们 自 定 义 的 类 型 
CustomerList::Node* node = MyList->GetFirst(); 
// i RA 
while (node) 


{ 


wxT("Dmitri"); 


Customer* Cust = node->GetData(); 
// 进行 一 些 人 处 理 
node = node->GetNext(); 


} 

// 返回 特定 位 置 的 节点 

node = MyList->Item(0); 

// 按照 排序 范 数 排序 
MyList->Sort(listcompare) ; 

// 移 除 包含 某 个 对 象 的 节点 
MyList->DeleteObject(CustA); 
// 我 们 需要 自己 释放 这 个 对 象 
delete CustA; 

// 找到 包含 某 个 对 象 的 节点 

node = MyList->Find(CustB); 
// 指示 内 部 数据 随 节点 的 删除 而 删除 
MyList->DeleteContents(true); 
// 删除 B 的 节点 的 时 候 , B 也 被 释放 了 
MyList ->DeleteNode(node) ; 

// 现在 调用 Clear, 所 有 的 节点 和 其 中 数据 都 将 被 释放 
MyList->Clear(); 

delete MyList; 


13.5 wxHashMap 


wxHashMap 类 是 一 个 简单 的 ,类 型 安全 的 并 且 效 率 很 不 错 的 哈 希 映射 类 , 它 的 接口 是 标准 的 STL 
容器 接口 的 一 个 子 集 .实际 上 , 它 是 在 标准 的 std:: map 和 非 标准 的 std::hash_map 之 后 才 可 以 设 
计 的 .通过 用 于 创建 哈 希 表 的 宏 , 你 可 以 选择 下 面 的 几 种 类 型 及 其 组 合作 为 哈 希 表 的 键 类 型 或 者 
数据 类 型 :int,wxString 或 void*( 任 意 类 型 ). 


有 三 个 用 来 定义 哈 希 映 射 类 的 宏 .要 定义 一 个 名 字 为 CLASSNAME, 键 类 型 为 wxString, 值 类 型 为 
VALUE T 类 型 的 哈 希 表 , 你 可 以 使 用 下 面 的 语法 : 


WX_DECLARE_STRING_HASH_MAP(VALUE_T， CLASSNAME); 
要 定义 一 个 名 字 为 CLASSNAME, 键 类 型 为 void*, 值 类 型 为 VALUE_T 类 型 的 哈 希 表 ,使 用 下 面 的 
定义 : 


WX_DECLARE_VOIDPTR_HASH_MAP(VALUE_T, CLASSNAME ; 


要 定义 一 个 名 称 为 CLASSNAME, 键 类 型 和 值 类 型 任意 类 型 的 哈 希 表 ,使 用 下 面 的 定义 : 


WX_DECLARE_HASH_MAP(KEY_T, VALUE_T, HASH_T, KEY_EQ_T, CLASSNAME); 


HASH_T 和 KEY_EQ_T 是 用 来 作为 哈 希 算法 和 上 比较 算法 的 函数 . wxWidgets 提 供 了 三 种 预定 义 
的 哈 希 算法 : wxlntegerHash 用 来 作为 整数 的 哈 希 算法 (int, long, short 和 它们 的 无 符号 变 体 都 可 
LA), wxStringHash 用 来 作为 字符 串 的 哈 希 算法 (wxString, wxChar, char 都 可 以 )， 
wxPointerHash 用 来 作为 任何 指针 类 型 的 哈 希 算法 .类 似 的 也 有 三 个 预定 义 的 比较 函数 : 
wxlntegerEqual, wxStringEqual 和 wxPointerEqual. 


下 面 的 代码 演示 了 wxHashMap 的 使 用 方法 : 


// 我 们 要 存放 在 哈 希 表 中 的 类 


class Customer 


public: 
int CustID; 
wxString CustName; 


}; 
// 定义 和 实现 我 们 自 定义 的 哈 希 表 . 
WX_DECLARE_HASH_MAP (int, Customer*, wxIntegerHash, 


wxIntegerEqual, CustomerHash) ; 


void HashTest() 


{ 


// 定义 一 个 自 定义 哈 希 表 的 实例 

CustomerHash MyHash; 

bool IsEmpty = MyHash.empty(); // will be true 
// 创建 几 个 对 象 

Customer* CustA = new Customer; 

CustA->CustID = 10; 

CustA->CustName = wxT("Bob"); 

Customer* CustB = new Customer; 

CustB->CustID = 20 
CustB->CustName = 
Customer* CustC = 
CustC->CustID = 5; 
CustC->CustName = wxT("Dmitri"); 
// 将 对 象 增加 到 哈 希 表 


wxT ("Sally"); 
new Customer; 


MyHash[CustA->CustID] = CustA; 
MyHash[CustB->CustID] = CustB; 
MyHash[CustC->CustID] = CustC; 


int Size = MyHash.size(); // will be 3 
// count KOROR, 含义 为 ;20 这 个 关键 值 在 哈 希 表 中 吗 ? 
int Present = MyHash.count(20); // 将 返回 1 
// 我 们 哈 希 表 的 自 定 义 节点 类 型 
CustomerHash::iterator i = MyHash.begin(); 
// DRAR 
while (i != MyHash.end()) { 
// first Woke sea, second 返 回 数据 
int CustID = i->first; 
Customer* Cust = i->second; 
// 作 一 些 处 理 
// 然后 处 理 下 一 个 数据 
i++; 
} 
// 将 键 值 为 19 的 数据 移出 哈 希 表 
MyHash.erase(10); 
// 移出 不 会 导致 数据 自动 释放 
delete CustA; 
// 返回 指定 键 值 的 一 个 节点 
CustomerHash::iterator i2 = MyHash.find(21); 
// 判断 是 否 找到 节点 
bool NotFound = (i2 == MyHash.end()); // 将 返回 True 
// 这 次 将 返回 有 效 的 节点 
i2 = MyHash.find(20); 
// 直接 移 除 节 点 
MyHash.erase(i2); 
delete CustB; 
// 副作用 : 下 面 语句 导致 哈 希 表 中 插入 一 个 键 值 为 30, 值 为 NULL 的 节点 ， 
Customer* Cust = MyHash[30]; // Cust 将 等 于 NULL 
// 清除 哈 希 表 中 的 节点 
MyHash.clear(); 
delete CustC; 


13.6 存储 和 使 用 日 期 和 时 间 


wxWidgets 提 供 了 一 个 功能 强大 的 类 wxDateTime 来 进行 时 间 和 日 期 相关 的 操作 ,包括 :格式 化 输 
出 ,时 区 ,时 间 和 日 期 计算 等 等 .还 提供 了 一 些 静 态 函 数 来 提供 当前 的 日 期 和 时 间 以 及 查询 某 个 给 
定 的 年 份 是 不 是 半年 等 .注意 即使 你 只 想 操作 日 期 或 者 是 时 间 , 你 仍然 可 以 使 用 wxDateTime 类 
型 . wxTimeSpan 和 wxDateSpan 类 型 提供 了 修改 一 个 wxDateTime 值 的 合适 的 方法 . 


wxDateTime 


wxDateTime 类 拥有 很 多 的 成 员 函 数 ,每 个 函数 的 含义 都 很 清晰 .完整 的 API 可 以 参考 wxWidgets 
的 相关 手册 ,下 面 只 对 其 中 使 用 最 频繁 的 范 数 进行 一 些 介绍 . 


注意 尽管 时 间 在 其 内 部 总 是 以 格林 威 治 时 间 (GMT) 存 储 的 ,但 是 你 通常 关心 的 是 本 地 时 区 的 时 
间 而 不 是 格林 威 治 时 间 , 因 此 , wxDateTime 的 构造 男 数 以 及 更 改 男 数 中 各 个 组 成 时 间 的 要 素 ( 比 
如 小 时 ,分 钟 和 秒 钟 ) 等 都 指 的 是 本 地 时 区 的 时 间 . 所 有 用 于 获取 时 间 和 日 期 的 画 数 返回 的 要 素 
(月 ,日 ,小 时 ,分 , 秒 等 ) 也 都 是 本 地 时 间 . 因 此 ,如 果 这 是 你 需要 的 ,你 不 需要 作 任 何 额 外 的 操作 ,如 果 
你 希望 操作 不 同时 区 的 时 间 , 请 参考 相关 的 文档 . 


wxDateTime 类 的 构造 和 更 改 


wxDateTime 可 以 通过 Unix 时 间 稚 , 仅 包含 时 间 的 信息 , 仅 包 含 日 期 的 信息 ,完整 的 时 间 日 期 信息 
等 途径 创建 .对 于 每 一 个 构造 玉 数 ,都 有 一 个 对 应 的 Set 范 数 用 来 更 改 已 经 设置 了 值 的 
wxDateTime 对 象 .也 可 以 通过 类 似 SetMonth 或 者 SetHour 等 函数 更 改 时 间或 者 日 期 中 的 某 个 要 
素 . 


wxDateTime(time_t) 范 数 根据 一 个 指定 的 Unix 时 间 稚 来 构造 对 象 . 
wxDateTime(const struct tm&) 范 数 根据 一 个 指定 的 C 语 言 标准 tm 结构 构造 对 象 . 


wxDateTime(wxDateTime_t hour, wxDateTime_t minute = 0, wxDateTime_t second = 0, 
wxDateTime_t millisec = 0) 根 据 指定 的 时 间 要 素 构 造 对 象 . 


wxDateTime(wxDateTime_t day, Month month = Inv_Month, int year = Inv_Year, 
wxDateTime_t hour = 0, wxDateTime_t minute = 0, wxDateTime_t second = 0, 
wxDateTime_t millisec = 0) 根据 指定 的 时 间 和 日 期 要 素 构 造 对 象 


wxDateTime 访 问 方法 


大 多 数 wxDateTime 类 的 访问 画 数 都 是 自 解释 的 ,比如 : GetYear, GetMonth, Getday, 
GetWeekDay, GetHour, GetMinute, GetSecond, GetMillisecond, GeTDayOfYear, 
GetWeekOfYear, GetWeekOfMonth#llGetYearDay=. wxDateTimeitte4 T FIL is 1 
数 : 


e GetTicks 返 回 一 个 Unix 时 间 戳 (也 就 是 自从 1970 年 1 月 1 日 午夜 以 来 的 秒 数 ). 


e |sValid 返 回 时 间 日 期 类 是 不 是 已 经 被 初始 化 (类 自 使 用 默认 构造 画 数 创建 以 后 始终 未 被 赋 
值 ). 


获取 当前 时 间 
wxDateTime 提 供 了 两 个 静态 画 数 返回 当前 时 间 : 


。 wxDateTime::Now 返回 精度 为 秒 的 当前 时 间 . 
。 wxDateTime::UNow 返回 精度 为 毫秒 的 当前 时 间 . 


时 间 和 字符 串 的 转换 


下 面 介绍 的 这 些 函 数 用 来 实现 时 间 和 字符 串 的 相互 转换 .将 时 间 转 化 成 字符 串 的 方法 是 比较 简 
单 的 :你 可 以 竺 时 间 转 换 成 本 地 格式 的 字符 串 (FormatDateflFormatTimeH žr), RA LAE LE 
ISO 8601 中 的 国际 标准 格式 来 显示 (FormatlSODate 函 数 和 FormatlSOTime 画 数 ), 也 可 以 以 自 
定义 的 格式 来 显示 (Format 汞 数 ). 


而 从 文本 到 时 间 的 转换 则 显得 更 复 杀 些 ,因为 可 能 的 时 间 格 式 太 多 了 .最 简单 的 函数 是 
ParseFormat 函 数 , 它 用 来 解析 那些 指定 格式 的 时 间 文 本 .ParseRfc822Date 函 数 用 来 解析 那些 
定义 在 RFC822 中 的 时 间 表 示 方 法 ,这 种 方法 在 email 或 者 互联 网 上 使 用 比较 普通 


最 有 趣 的 文本 到 时 间 转 换 函 数 是 ParseTime,ParseDate 和 ParseDateTime 本 数 ,它们 将 尽量 匹 
配 各 种 格式 的 时 间 文 本 .除了 预定 义 的 那些 标准 格式 以 外 ,ParseDateTime 函 数 其 至 可 以 支持 那 
些 类 似 "tomorrow"( 明 天 ), "March first"( 三 月 一 日 ) 以 及 "next Sunday"( 下 个 星期 天 ) 这 样 的 时 间 . 


日 期 比较 


两 个 WxDateTime 对 象 可 以 通过 各 种 函数 进行 比较 ,这 些 函 数 都 返回 bool 类 型 的 值 .这 些 玉 数 包 
括 :lsEqualTo, IsEarlierThan, IsLaterThan, IsSameDate 和 IsSameTime 等 . 


而 lsStrictlyBetween 和 lsBetween 则 用 来 比较 某 个 日 期 是 不 是 在 两 个 日 期 之 间 . 这 两 个 函数 的 区 
别 在 于 ,如 果 要 比较 的 时 间 刚 好 等 于 其 中 的 与 其 比较 的 边界 值 的 时 候 ,前 者 返回 False 而 后 者 返 
回 True. 


日 期 计算 


wxWidgets 提 供 了 两 个 非常 灵活 的 类 wxTimeSpan 和 wxDateSpan 来 辅助 进行 日 期 和 时 间 的 计 
算 . wxTimeSpan 用 来 计算 那些 以 毫秒 为 单位 的 ,跨度 不 大 的 ,快速 的 和 精确 的 计算 ,而 
wxDateSpan 则 用 来 进行 跨度 比较 大 的 比如 几 周 或 者 几 个 月 的 计算 .wxDateSpan 将 尽 可 能 使 用 
更 自然 的 方法 来 进行 计算 ,因此 其 含义 有 时 候 并 不 象 它 看 上 去 的 那样 精确 .比如 1 月 31 日 加 上 一 
个 月 将 返回 二 月 28 日 (或 29 日 ), 也 就 是 说 是 二 月 的 最 后 一 天 ,而 不 是 永远 不 可 能 存在 的 二 月 31 
日 .通常 ,你 比较 喜欢 这 样 的 结果 ,不 过 有 时 候 相 应 的 减法 运算 可 能 也 会 把 你 搞 糊 涂 ,比如 二 月 28 
日 减 去 一 个 月 的 结果 的 一 月 28 日 而 不 是 一 月 31 日 . 


日 期 类 型 可 以 进行 的 操作 很 多 ,但 是 这 些 操作 的 组 合 却 未 必 是 有 效 的 .比如 :对 一 个 日 期 进行 乘法 
运算 是 无 效 的 ,而 对 于 任何 一 个 表示 时 间 间 隅 的 类 (wxTimeSpan 或 wxDateSpan) 进 行 乘法 运算 
则 没有 任何 问题 . 


e 加 法 : wxTimeSpan 或 wxDateSpan 可 以 和 wxDateTime 进 行 加 法 运算 ,返回 一 个 新 的 

wxDateTime 对 象 . 两 个 相同 类 型 的 时 间 间 陋 类 也 可 以 进行 加 法 运算 ,返回 一 个 新 的 同样 类 
型 的 对 象 . 

。 减法 : 减法 适用 和 加 法 同样 的 规则 , 领 外 的 一 个 规则 是 两 个 wxDateTime 对 象 相 减 返 回 一 个 
wxTimeSpan 对 象 . 

。 乘法 : wxTimeSpan 或 wxDateSpan 对 象 可 以 乘 以 一 个 整数 ,返回 一 个 同样 类 型 的 对 象 . 

e Unary 相 减 :wxTimeSpan 或 wxDateSpan 对 象 可 以 定义 为 负数 ,导致 相反 的 时 间 方 向 上 的 同 
样 的 间隔 . 


下 面 的 例子 演示 了 wxDateSpan 和 wxTimeSpan 的 用 法 ,更 多 的 用 法 请 参考 WxWidgets 的 相关 手 
册 . 


void TimeTests() 

{ 
/ 获取 当前 时 间 和 日 期 
wxDateTime DT1 = wxDateTime: :Now(); 
// 创建 一 个 2 星期 需 1 天 ,或 者 说 15 天 的 间隔 
wxDateSpan Span1(0, 0, 2, 1); 
// 今天 减 去 15 天 
wxDateTime DT2 = DT1 - Spaní; 
// 用 静态 方法 创建 一 天 的 间隔 
wxDateSpan Span2 = wxDateSpan: :Day(); 
// Span3 将 代表 14 天 的 间隔 
wxDateSpan Span3 = Span1 - Span2 ， 
// 0 R (这 个 间隔 将 用 2 周 来 表示 ) 
int Days = Span3.GetDays(); 
// 14 R (2 周 ) 
int TotalDays = Span3.GetTotalDays(); 
// 之 前 两 周 
wxDateSpan Span4 = -Span3; 
// 3 个 月 的 间隔 
wxDateSpan Span5 = wxDateSpan::Month() * 3; 
// 19 小 时 5 分 6 秒 的 间隔 
wxTimeSpan Span6(10, 5, 6, 0); 
// DT2 增 加 固定 的 间隔 Span6 
wxDateTime DT3 = DT2 + Span6; 
// Span7 是 相反 方向 上 的 3 倍 Span6 的 间隔 . 
wxTimeSpan Span7 = (-Span6) * 3; 
// SpanNeg 将 返回 True， 这 个 间隔 是 负 方 向 的 . 
bool SpanNeg = Span7.IsNegative(); 
// 适用 静态 方法 创建 一 个 1 小 时 的 间隔 
wxTimeSpan Span8 = wxTimeSpan: :Hour(); 
// 1 小 时 当然 小 于 39 小 时 (这 里 使 用 绝对 值 ) 
bool Longer = Span8.IsLongerThan(Span7) ; 


13.7 HEM AMSA A 


wxWidgets 内 部 使 用 了 一 些 其 它 的 数据 类 型 ,也 在 一 些 公 用 API 中 作为 参数 和 返回 值 ,并 且 
wxWidgets 也 鼓励 程序 员 在 它们 的 代码 中 使 用 这 些 类 型 . 


wxObject 
wxObject 类 是 所 有 wxWidgets 类 的 基 类 , 它 提供 的 功能 包括 运行 期 类 型 信息 ,引用 技术 , 虚 析 构 函 


数 ,可 选 的 调试 版 本 的 new 和 delete 函 数 等 . 某 些 wxObject 对 象 的 成 员 画 数 还 使 用 了 用 于 存储 
meta-data 的 wxClasslnfo 对 象 . 


MyWindow* window = wxDynamicCast (FindWindow(ID_MYWINDOW), MyWindow); 


lIsKindOf 范 数 判 断 对 象 是 否 是 传 入 的 wxClasslnfo 指 向 的 类 型 . 


bool tmp = obj->IsKindOf(CLASSINFO(wxFrame) ); 


Ref HB 4 const wxObject& 类 型 , 它 的 作用 是 将 当前 对 象 的 数据 替换 为 参数 对 象 的 引用 . 
当前 对 象 的 引用 技术 减 一 ,如 果 需 要 则 释放 当前 对 象 数据 ,参数 对 象 的 引用 技术 则 加 一 . 


UnRef 则 将 对 象 内 部 数据 的 引用 记 数 器 减 一 ,如 果 已 经 减 到 0 则 释放 当前 对 象 数 据 . 
wxLongLong 


wxLongLong 类 用 来 存储 64 位 整数 .如 果 本 地 系统 支持 64 位 长 整数 则 使 用 本 地 系统 提供 的 实现 ， 

否则 将 使 用 模拟 的 64 位 实现 .这 个 类 的 使 用 和 其 它 标 准 的 数字 类 型 没有 区 别 .注意 它 是 一 个 有 符 
号 数字 ,如 果 想 使 用 它 的 无 符号 版 本 ,可 以 使 用 wxULongLong 类 型 ,后 者 的 API 和 前 者 几乎 完全 一 
样 ,除了 个 别 的 范 数 (比如 求 绝 对 值 画 数 ) 可 能 返回 不 同 的 结果 .除了 一 般 的 计算 函数 以 外 ,另外 的 
几 个 常用 的 函数 包括 : 


e Abs 辑 】 数 返回 wxLongLong 的 绝对 值 ,如 果 是 作为 常量 引用 调用 的 这 个 函数 , 则 返回 源 对 象 
的 一 个 拷贝 ,否则 将 修改 源 对 象 的 内 部 数值 . 

e ToLong 画 数 将 其 转换 成 一 个 长 整 型 ,如 果 由 于 存在 精度 丢失 ,在 调试 版 本 中 将 引发 一 个 断 
Be Pik. 


e ToString 将 内 部 存储 的 数据 转换 成 一 个 wxString 类 型 . 
wxPoint 和 wxRealPoint 


wxPoint 在 wxWidgets 中 使 用 比较 普通 ,常用 来 代表 屏幕 或 者 窗口 上 的 一 个 确定 的 位 置 . 正 如 它 的 
名 字 的 意思 一 样 , 它 内 部 的 数据 用 x 和 y 两 个 整数 代表 一 个 座 标 值 .其 数据 成 员 是 以 public 方 式 定 
义 的 ,可 以 直接 被 其 它 对 象 访问 .wxPoint 支 持 和 另外 一 个 wxPoint 对 象 或 者 wxSize 对 象 进 行 加 


法 和 减法 的 运算 .wxRealPoint 对 象 和 wxPoint 对 象 类 似 , 不 过 其 内 部 成 员 是 double 类 型 ,并 且 只 支 
持 和 别 的 wxRealPoint 类 型 进行 加 减 运算 . 


构造 wxPoint 实 例 的 方法 很 直接 : 


wxPoint myPoint(50, 60); 


wxRect 


wxRect 通 常 在 绘画 或 者 窗口 类 中 使 用 (比如 wxDC 或 者 wxtreeCtrl), 用 来 定义 一 个 矩形 区 域 .其 内 
部 的 数据 成 员 除 了 x 和 y 以 外 ,还 包括 宽度 和 高 度 . 所 有 的 成 员 都 是 public 类 型 ,可 以 直接 被 其 它 的 
类 访问 .除了 同类 型 之 间 的 加 减 运算 ,wxRect 还 支持 一 些 其 它 运 算 : 


GetRight 返 回 德 形 最 右边 的 X 座 标 . 
GetBottom 返 回 底 端的 Y 座 标 . 
GetSize 返 回 一 个 wxSize 对 象 用 来 表征 矩形 区 域 的 宽度 和 高 度 . 


Inflate 函 数 增加 算 形 区 域 的 大 小 ,如 果 只 有 一 个 参数 , 则 长 和 宽 增加 一 样 的 大 小 ,如 果 是 两 个 参数 ， 
则 长 和 宽 分 别 增 加 对 应 的 大 小 . 


Inside 函 数 判 断 某 个 点 是 否 位 于 和 矩形 区 域 以 内 ,点 的 格式 可 以 是 单独 的 XY 座 标 ,也 可 以 是 一 个 


wxPoint 类 型 . 
Intersects 判 断 某 个 矩 形 是 否 和 另外 一 个 和 矩形 有 重 党 区 域 . 


Offset 将 当前 矩形 偏 移 一 段 举例 , 偏 移 的 位 置 既 可 以 通过 X 和 YY 单独 指定 ,也 可 以 通过 WxPoint 来 
指定 


下 面 的 代码 演示 了 wxRect 的 三 种 构造 画 数 : 


wxRect myRect1(50, 60, 100, 200); 
wxRect myRect2(wxPoint(50, 60), wxPoint(150, 260)); 
wxRect myRect3(wxPoint(50, 60), wxSize(100, 200)); 


wxRegion 


wxRegion 用 来 代表 设备 上 下 文 或 者 窗口 上 的 一 个 简单 的 或 者 复 条 的 区 域 . 它 使 用 了 引用 记 数 ， 
因此 拷贝 和 赋值 操作 是 非常 快速 的 . 它 的 主要 用 途 是 用 来 定义 或 者 查询 某 个 需要 裁 瘟 或 者 更 新 
的 区 域 . 


Contains 函 数 在 其 参数 指定 的 座 标 , wxPoint, 和 矩形 或 WxRect 被 包含 在 区 域内 时 返回 True. 
GetBox 画 数 返 回 一 个 包含 整个 区 域 的 wxRect 对 象 . 


Intersect 函 数 在 指定 的 矩形 ,wxRect 或 wxRegion 参 数 和 本 区 域 有 重 辣 的 时 候 返 回 True. 


Offset 对 区 域 进行 指定 x 和 y 方 向 数量 的 平移 . 


Subtract, Union 和 Xor 玉 数 提供 了 一 种 灵活 的 机 制 来 改变 当前 区 域 .这 三 个 函数 的 变 体 孙 
数 名 相同 ,参数 不 同 ) 超 过 10 个 .所 有 这 些 函 数 都 可 以 支持 wxRegion 参 数 或 者 wxPoint 参 数 .请 参 
考 wxWidgets 的 相关 手册 内 容 . 


下 面 的 代码 演示 了 四 种 创建 区 域 的 方法 ,所 有 这 些 方 法 创建 的 结果 都 是 一 样 的 区 域 : 


wxRegion myRegion1(50, 60, 100, 200); 

wxRegion myRegion2(wxPoint(50, 60), wxPoint(150, 260)); 
wxRect myRect(50, 60, 100, 200); 

wxRegion myRegion3(myRect); 

wxRegion myRegion4(myRegion1) ; 


{RF LA FawxRegionlterator 3 eis HET YEH Ky, PES ee es A Rl 
那些 需要 绘制 的 矩形 区 域 ,你 可 以 使 用 下 面 的 代码 : 
// 在 窗口 需要 被 重 绘 的 时 候 调 用 
void MyWindow: :OnPaint(wxPaintEvent& event) 
wxPaintDC dc(this); 
wxRegionIterator upd(GetUpdateRegion()); 
while (upd) 
{ 
wxRect rect(upd.GetRect()); 
// 刷新 这 个 矩形 区 域 


ERS. 
upd ++ ; 


wxSize 


A a ti 定 窗口 ,控件 ,画布 等 等 对 象 的 大 小 .很 多 需要 返回 大 小 信息 
的 函数 也 将 返回 这 个 对 象 类 型 . 


GetHeight 和 GetWidth 函 数 返 回 高 度 和 宽度 . 
SetHeight 和 SetWidth 范 数 设置 整数 的 高 度 和 宽度 . 
Set 男 数 则 使 用 两 个 整数 参数 来 同时 改变 高 度 和 宽度 . 
WwWxSize 的 创建 也 非常 简单 ,如 下 所 示 : 


wxSize mySize(100, 200); 


wxVariant 


wxVariant 类 用 来 表示 那些 可 以 是 任意 类 型 的 数据 .数据 的 类 型 甚至 可 以 动态 的 改变 .这 种 类 型 在 
解决 某 些 特定 的 问题 的 时 候 很 有用 处 ,比如 要 编辑 不 同类 型 的 数据 的 编辑 器 或 者 用 于 实现 远程 
过 程 调 用 . 


wxVariant 类 型 可 以 存储 的 数据 包括 bool, char, double, long, wxString, wxArrayString, wxList, 
wxDateTime, void* 和 可 变 类 型 变量 列表 .不 过 ,你 还 是 可 以 通过 实现 wxVariantData 的 派生 类 的 
发 生 扩 展 wxVariant 可 以 支持 的 数据 类 型 .在 构造 和 赋值 的 时 候 ,只 需要 将 其 当成 wxVariantData 
使 用 就 可 以 了 .当然 ,不 方便 的 地 方 在 于 如 果 你 要 访问 自 定义 的 数据 类 型 ,需要 先 将 其 转换 成 
wxVariantData 对 象 ,而 不 象 内 置 支持 的 类 型 那样 ,有 对 应 的 类 似 于 GetLong 这 样 的 函数 支持 . 


另外 ,要 记 住 不 是 所 有 的 类 E 比如 你 不 可 能 把 一 个 bool 型 的 数据 转换 成 
wxDateTime 类 型 ,也 不 可 能 把 一 个 整数 转换 成 wxArrayString, 你 需要 按照 一 些 常 识 来 判断 哪些 
数据 类 Maem pu oo Ee FY La it Get Type RG Bl 4 FIBER AS RB. 
下 面 举 一 个 使 用 wxVariant 类 的 简单 的 例子 : 


wxVariant Var; 

// 存储 WwxDateTime 类 型 ， 获 取 wxString 类 型 
Var = wxDateTime: :Now(); 

wxString DateAsString = Var.GetString(); 
// 存储 一 个 wxString 类 型 ， 获 取 一 个 double 类 型 
Var = wxT("10.25"); 

double StringAsDouble = Var.GetDouble(); 
// 当前 的 类 型 应 该 是 "string" 

wxString Type = Var.GetType(); 

// 下 面 演示 一 个 无 理 取 闸 的 转换 

// 由 于 不 能 转换 , 所 以 转换 的 结果 为 9 

char c = Var.GetChar(); 


第 十 三 章 小 结 


wxWidgets 提 供 的 多 种 数据 结构 类 型 让 你 可 以 很 容易 的 从 wxWidgets 提 供 的 API 中 或 者 你 自己 
的 应 用 程序 中 获取 和 使 用 各 种 类 型 的 结构 化 数据 . 通过 功能 强大 的 数据 类 型 


wxRegEx,wxStringTokenizer,wxDateTime,wxVariant 等 等 ,你 几乎 不 需要 使 用 任何 第 三 方 的 库 
就 可 以 处 理 各 种 数据 . 


接 下 来 ,我 们 来 看 看 wxWidgets 提 供 的 从 文件 或 者 流 中 污 取 或 者 写 入 数据 的 方法 . 


第 十 四 章 文件 和 流 操 作 


在 这 一 章 里 ,我 们 来 看 看 wxWidgets 提 供 的 底层 文件 操作 对 象 以 及 流 操作 .wxWidgets 的 流 对 象 
不 但 能 使 得 你 的 点 用 程序 可 以 和 各 种 标准 的 C++ 库 打 交道 ,而 且 还 提供 完整 的 压缩 , 写 zip 文 档 
以 及 socket 读 写 等 操作 .我 们 还 将 描述 一 下 wxWidgets 提 供 的 虚拟 文件 系统 , 它 让 你 的 应 用 程序 
可 以 很 容易 的 从 非常 规 文件 中 获取 各 种 资源 . 


14.1 文件 类 和 加 数 


wxWidgets 提 供 了 一 系列 的 平台 无 关 的 文件 义理 功能 .在 概览 所 有 文件 函数 之 前 ,我 们 先 来 看 看 
几 个 主要 的 类 . 


wxFile 和 wxFFile 


wxFile 类 可 以 用 来 处 理 底层 的 文件 输入 输出 . 它 封 装 了 常用 的 用 于 操作 整数 文件 标识 符 的 标准 C 
操作 (打开 关闭 , 读 写 ,移动 游标 等 ), 但 是 和 标准 C 不 同 的 是 , 它 使 用 wxLog 类 来 报告 错误 并 且 在 析 
构 函 数 中 自动 关闭 文件 .而 wxFFile 则 提供 缓冲 的 输入 输 出 操作 ,内 部 使 用 的 是 FILE 类 型 的 指针 . 


你 可 以 通过 下 面 的 方法 创建 一 个 wxFile 对 象 :使 用 默认 构造 事 数 然后 调用 Create 或 者 Open 加 数 ; 
或 者 直接 在 构造 罚 数 中 指明 文件 名 和 打开 模式 (wxFile::read, wxFile::write 或 
WwWxFile::read_write); 或 者 直接 使 用 已 经 存在 的 整数 文件 描述 符 ( 相 关 构 造 画 数 或 者 默认 构造 范 
数 加 Attach 函 数 ).Close 函 数 关 闭 当 前 使 用 的 文件 ,文件 也 将 在 析 构 画 数 中 视 需 要 进行 关闭 . 


从 文件 中 读 取 数据 使 用 Read 男 数 ,参数 为 一 个 void 和 一 个 缓冲 区 大 小 ,返回 实际 读 取 的 数值 大 小 
或 者 wxlnvalidqOffset 如 果 污 取 过 程 发 生 错 误 .使 用 Write 函 数 将 指定 大 小 的 void 类 型 的 缓冲 区 写 
入 文件 ,如 果 你 希望 写 操 作 立 即 写 到 物理 文件 ,你 需要 使 用 Flush 画 数 . 


Eof 函 数 用 来 检测 当前 的 文件 指针 是 否 位 于 文件 结尾 的 位 置 (而 wxFFile 的 Eof 范 数 只 有 在 其 读 盾 
作 越 过 了 文件 结尾 的 时 候 才 返回 True). 你 可 以 用 Length 画 数 返 回 文件 的 长 度 . 


$i 


Seek#lSeekEnd HA I H HS ay EA FEF AMR a Aa i. Tellig 
数 返 回 wxFileOffset 类 型 的 当前 文件 指针 位 置 ,这 个 类 型 在 支持 64 位 操作 系统 上 是 64 位 整数 , 否 
则 是 32 位 整数 . 


Access 画 数 是 一 个 静态 本 数 ,用 来 判断 某 个 文件 是 否 可 以 以 指定 的 模式 打开 ,而 Exists 函 数 则 用 
来 判断 指定 的 文件 是 否 存在 . 


下 面 的 代码 演示 了 怎样 使 用 wxFile 打 开 一 个 文件 并 且 将 其 内 容 读 取 到 一 个 数组 中 : 


#include "wx/file.h" 

if (!wxFile: :Exists(wxT("data.dat"))) 
return false; 

wxFile file(wxT("data.dat")); 

if ( !file.IsOpened() ) 
return false; 

// 文 件 大 小 

wxFileOffset nSize = file.Length(); 

if ( nSize == wxInvalidoffset ) 
return false; 

// 将 所 有 内 容 读 取 到 一 个 数组 中 

wxUint* data = new wxUint8[nSize]; 

if ( fileMsg.Read(data, (size_t) nSize) != nSize ) 


delete[] data; 
return false; 


} 
file.Close(); 


下 面 的 代码 则 演示 了 怎样 将 一 个 文本 框 的 所 有 内 容 写 入 到 文件 中 : 


bool wWriteTextCtrlContents(wxTextCtrl* textCtrl, 
const wxString& filename) 


{ 
wxFile file; 
if (!file.Open(filename, wxFile: :write) ) 
return false 
int nLines = textCtrl->GetNumberOfLines(); 
bool ok = true; 
for ( int nLine = 0; ok && nLine &lt; nLines; nLine++ ) 
ok = file.Write(textCtrl->GetLineText(nLine) + 
wxTextFile: :GetEOL()); 
} 
file.Close(); 
return ok; 
} 
wxTextFile 


wxTextFile 提 供 了 一 种 非常 直接 的 方式 来 以 行为 单位 读 取 和 写 入 小 型 的 文本 文件 . 


使 用 Open 画 数 将 这 个 文本 文件 读 取 到 内 存 中 并 且 以 行为 单位 进行 分 割 ,使 用 Write 本 数 写 回 到 
文本 文件 .你 可 以 使 用 GetLine 函 数 或 者 直接 按照 数组 的 方式 操作 某 个 特定 的 行 .或 者 使 用 
GetFirstLine,GetNextLine#GetPrevLine ż 47 ig 4 AddLine 和 InsertLine 用 来 增加 新 

行 ,RemoveLine 用 来 移 除 特定 的 行 , Clear 本 数 则 用 来 清空 所 有 的 行 . 


下 面 的 例子 演示 了 将 文本 文件 中 的 每 一 行 都 增加 一 个 前 导 文 本 的 方法 : 


#include "wx/textfile.h" 
void FilePrepend(const wxString& filename, const wxString& text) 


wxTextFile file; 
if (file.Open(filename) ) 


{ 
size bt ay 
for (i = 0; i &lt; file.GetLineCount(); i++) 

file[i] = text + file[i]; 

file.write(filename) ; 

} 

} 
wxTempFile 


wxTempFile 是 wxFile 的 一 个 派生 类 , 它 使 用 临时 文件 来 宇 入 数据 ,数据 在 Commit 画 数 被 调用 之 
前 不 会 被 写 入 .如 果 你 需要 写 一 些 用 户 数据 ,你 可 以 将 其 写 在 临时 文件 里 , 它 的 好 义 是 :如 果 遇 到 
突然 的 断 电 或 者 应 用 程序 不 可 知 错误 或 者 其 它 大 的 错误 时 ,临时 文件 不 会 对 磁盘 上 的 文件 系统 
造成 任何 伤害 . 


提示 :文档 /视图 框架 在 创建 一 个 输出 流 然后 调用 SaveObject 的 时 候 没 有 使 用 临时 文件 .你 可 以 
党 试 重 载 其 DoSaveDocument 辑 数 ,在 其 中 构建 一 个 wxFileOutputStream 并 且 让 其 使 用 一 个 临 
时 文件 wxTempFile 对 象 ,在 全 部 数据 写 完 以 后 ,调用 Sync 玉 数 和 Commit 范 数 业 其 写 入 临时 文件 . 


wxDir 


wxDir — 143 AS 1} F Unix_t Mopen/read/closedir AA # CRIME EFPIA M 
件 .wxDir 既 支持 枚 举目 录 中 的 文件 ,也 支持 枚 举目 录 中 的 子 目录 . 它 还 提供 了 一 个 灵活 的 北 为 枚 
举 文件 的 方法 Traverse 函 数 , 和 另外 一 种 简单 的 方法 : GetAllFiles 函 数 . 


首先 ,你 需要 调用 Open 函 数 打 开 一 个 目录 (或 者 通过 构造 男 数 直接 赋值 ), 然 后 调用 GetFirst 范 数 ， 
参数 为 一 个 指向 字符 串 类 型 的 指针 用 来 接收 找到 的 文件 名 ,一 个 可 选 的 文件 通配符 (默认 为 所 有 
文件 ) 和 一 个 可 选 的 选项 .然后 调用 GetNext 范 数 直 到 其 返回 False. 文 件 通配符 可 以 是 固定 的 文 
件 名 以 及 包含 “(匹配 任意 字符 "和 "?"( 匹 配 单个 字符 ) 的 通配符 .选项 参数 可 选 的 值 

为 :WXxDIR_FILES( 所 有 文件 ), wxDIR_DIRS( 所 有 文件 夹 ),wxDIR_HIDDEN( 隐 藏 文件 ) 以 及 
wxDIR_DOTDOT("." 和 "..") 以 及 它们 的 组 合 , 默 认 值 为 除了 最 后 一 项 的 所 有 文件 . 


下 面 是 一 个 例子 


#include "wx/dir.h" 
wxDir dir(wxGetCwd()); 
if ( !dir.IsOpened() ) 


// 如 果 遇 到 这 个 情况 , wxDir 已 经 显示 了 一 个 出 错 信 息 
// 所 以 直接 返回 就 可 以 了 
return; 


puts("Enumerating object files in current directory:"); 
wxString filename; 

wxString filespec = wxT("*.*"); 

int flags = wxDIR_FILES|wxDIR_DIRS; 

bool cont = dir.GetFirst(&filename, filespec, flags); 
while ( cont ) 


wxLogMessage(wxT("%s\n"), filename.c_str()); 


cont = dir.GetNext(&filename) ; 


} 


a ee 如 果 wxDir 打 开 的 时 候 出 现 错误 ,将 会 弹出 一 个 错误 消息 ,如 果 想 禁止 
个 消息 ,你 可 以 临时 通过 设置 wxLogNull 的 方法 ,如 下 所 示 : 


wxLogNull logNull; 
wxDir dir(badDir); 
if ( !dir.IsOpened() ) 


return; 


wxFileName 


wxFileName 用 来 处 理 文件 名 . 它 可 以 分 解 和 组 合 文件 名 ,还 提供 了 很 多 额外 的 操作 ,其 中 某 些 为 
静态 函数 .下 面 演示 了 一 些 例子 ,更 多 的 功能 请 参考 wxWidgets 的 手册 : 


#include "wx/filename.h" 

// 使 用 字符 串 创 建文 件 名 

wxFileName fname(wxT("MyFile.txt")); 

// Normalize, windows FE EXT RAN aa 

// 确保 文件 名 为 长 文件 名 格式 

fname .Normalize(wxPATH_NORM_LONG|wxPATH_NORM_DOTS|wxPATH_NORM_TILDE | 
wxPATH_NORM_ABSOLUTE ) ; 

/ 返回 全 路 径 


wxString filename = fname.GetFullPath(); 
/ 返回 相对 于 当前 目录 的 路 径 
fname .MakeRelativeTo(wxFileName: :GetCwd()); 
// 文件 存在 吗 ? 
bool exists = fname.FileExists(); 
// 另外 一 个 文件 存在 吗 ? 
bool exists2 = wxFileName: :FileExists(wxT("c:\\temp.txt")); 
/ 返回 文件 名 的 名 称 部 分 
E name = fname.GetName(); 
返回 路 径 部 分 
pee path = fname.GetPath(); 
// 在 windows 系 统 上 返回 相应 的 短路 径 文 件 名 , 其 它 平台 
// 返回 本 身 
wxString shortForm = fname.GetShortPath(); 
// 创建 一 个 文件 夹 
bool ok = wxFileName: :Mkdir(wxT("c:\\thing")); 


File Functions 


下 表 列 出 了 一 些 有 用 的 静态 文件 操作 函数 ,它们 定义 在 头 文件 wx/filefn.h 中 .请 同时 参考 
We te 40wxFileName::FileExistsEN 2X. 


wxDirExists(dir) 
wxConcatFiles(f1, f2, f3) 


wxCopyFile(f1, f2, 
overwrite) 


wxFileExists(file) 


wxFileModificationTime(file) 


wxFileNameFromPath (file) 


wxGetCwd() 


wxGetdiskSpace (path, 
total, free) 


wxlsAbsolutePath(path) 


wxMkdir(dir, 
permission=777) 


wxPathOnly(path) 
wxRemoveFile(file) 


wxRenameFile(file1, file2) 


wxRmdir(file) 


wxSetWorkingDirectory(file) 


是 否 目录 存在 . 参考 wxFileName::DirExists 
将 f1 和 f2 合 并 为 f3, 成 功 时 返回 True. 


拷贝 f1 到 人 ,可 选择 是 否 履 盖 已 存在 的 他. 返回 Bool 型 


测试 是 否 文件 存在 . 参考 wxFileName::FileExists 
返回 文件 修改 时 间 (time_t 类 型 ). 参考 


wxFileName::GetModificationTime, 它 返回 wxDateTime 类 
型 


返回 文件 全 路 径 的 文件 名 部 分 . 推荐 使 用 
wxFileName::SplitPathE 2X 


返回 当前 工作 目录 . BSwxFileName::GetCwd 
返回 指定 路 径 所 在 的 磁 意 的 全 部 空间 和 空 闪 空间 ,空间 为 


wxLongLong 类 型 . 

测试 指定 的 路 径 是 否 为 绝对 路 径 . 

创建 一 个 目录 ,其 父 目录 必须 存在 ,可 选 指 定 目录 访问 掩 码 . 
返回 bool 型 


给 定 全 路 径 的 目录 部 分 . 
删除 文件 ,成 功 时 返回 True. 


重 命名 文件 ,成 功 时 返回 True. 如 果 需 要 进 
接 返 回 False. 


移 除 空 目 录 , 成 功 时 返回 True. 
置 当 前 工作 目录 ,返回 bool 型 . 


井 行文 件 拷贝 , 则 直 


wxWidgets 同 样 提供 了 许多 画 数 来 封装 标准 C 本 数 ,比如 : wxFopen, wxFputc 和 wxSscanf, 这 些 
画 数 没有 在 手册 中 记录 ,不 过 你 应 该 可 以 在 include/wx/wxchar.h 中 找到 它们 . 


另外 一 个 有 用 的 宏 是 wxFILE_SEP_PATH, 它 代表 了 不 同 平 台 上 的 路 径 分 割 符 ,比如 在 windows 
平台 上 它 代表 "\", 而 在 Unix 平 台 上 则 代表 "A". 


14.2 沅 操作 相 天 类 


所 谓 流 模型 ， 指 的 是 一 种 用 于 提供 相对 于 文件 读 写 更 高 层 的 数据 读 写 的 模型 .使 用 流 模型 ,你 的 
代码 不 需要 关心 当前 操作 的 是 文件 ,内 存 还 是 socket( 参 考 第 18 章 ," 使 用 wxSocket 编 程 ", 其 中 演 
示 了 用 流 方式 使 用 socket 的 方法 ). 某 些 wxWidgets 标 准 类 同时 支持 文件 读 写 操作 和 流 读 写 操 作 ， 
比如 wxlmage 类 . 


wxStreamBase 类 是 所 有 流 类 的 基 类 , 它 声 明 的 函数 包括 类 似 OnSysRead 和 OnSysWrite 等 需要 
继承 类 实现 的 函数 .其 子 类 wxlnputStream 和 wxOutputStream 则 提供 了 更 具体 的 流 类 (比如 
wxFilelnputStream 和 wxFileOutputStream 子 类) 共同 需要 的 用 于 读 写 操作 的 基本 阔 数 .让 我 们 
来 具体 来 看 一 下 wxWidgets 提 供 的 各 种 流 操作 相关 类 . 


文件 流 


wxFilelnputStream 和 wxFileOutputStream 是 基于 wxFile 类 实现 的 ,可 以 通过 文件 名 ,wxFile 对 象 
或 者 整数 文件 描述 符 的 方式 来 进行 初始 化 .下 面 的 例子 演示 了 使 用 wxFilelnputStream 来 进行 文 
件 读 取 , 文 件 指针 移 位 并 读 取 当 前 位 置 数据 等 . 


#include "wx/wfstream.h" 

// ERR RE PREF AAT ARAZSM st BH. 

// WwWXFileInputStream 将 在 析 构 函数 中 自动 关闭 对 应 的 文件 描述 符 . 

wxFileInputStream inStream(filename) ; 

// 读 100 个 字 节 

int byteCount = 100; 

char data[100]; 

if (inStream.Read((void*) data, byteCount). 
LastError() != wxSTREAM_NOERROR) 


// 发 生 了 异常 
// 异常 列表 请 参考 WxStreamBase 的 相关 文档 ， 


} 

// 你 可 以 通过 下 面 的 方法 判断 到 底 成 功 读 取 了 多 少 个 字 

size_t reallyRead = inStream.LastRead(); 

// 将 文件 游标 移动 到 文件 开始 处 . 

// SeekI 图 数 的 返回 值 为 移动 游标 以 前 的 游标 相对 于 文件 起 始 处 的 位 置 
off_t oldPosition = inStream.SeekI(0, wxFromBeginning); 
// 获得 当前 的 文件 游标 位 置 

off_t position = inStream.TellI(); 


使 用 wxFileOutputStream 的 方法 也 很 直观 .下 面 的 代码 演示 了 使 用 wxFilelnputStream 和 
wxFileOutputStream 实 现 文件 拷贝 的 方法 .每 次 拷贝 1024 个 字 节 .为 了 使 代码 更 简介 ,这 里 没有 
显示 错误 义理 的 代码 . 


// 下 面 的 代码 实现 固定 单位 大 小 的 流 拷贝 . 

// 缓冲 区 的 使 用 是 为 了 加 快 拷贝 的 速度 . 

void BufferedCopy(wxInputStream& inStream, wxOutputStream& outStream, 
size_t size) 

{ 


static unsigned char buf[1024]; 
size_t bytesLeft = size; 
while (bytesLeft &gt; 0) 


{ 
size_t bytesToRead = wxMin((size_t) sizeof(buf), bytesLeft); 
inStream.Read((void*) buf, bytesToRead) ; 
outStream.Write((void*) buf, bytesToRead); 
bytesLeft -= bytesToRead; 

} 


void CopyFile(const wxString& from, const wxString& to) 


wxFileInputStream inStream( from) ; 
wxFileOutputStream outStream(to); 
BufferedCopy(inStream, outStream, inStream.GetSize()); 


} 


wxFFilelnputStream 和 wxFFileOutputStream 跟 wxFilelnputStream 和 wxFileOutputStream 的 
用 法 几乎 完全 一 样 , 不 同 之 处 在 于 前 者 是 基于 wxFFile 类 而 不 是 wxFile 类 的 . 因此 它们 的 初始 化 
方法 也 不 同 ,相应 的 ,前 者 可 以 使 用 FILE 指 针 或 wxFFile 对 象 来 初始 化 .文件 结束 处 理 相 应 的 有 所 
不 同 : wxFilelnputStream 在 最 后 一 个 字 节 被 读 取 的 时 候 报告 wxSTREAM_EOF , 而 
wxFFilelnputStream 则 在 最 后 一 个 字 节 以 后 进行 读 操作 的 时 候 返 回 wxSTREAM_EOF. 


内 存 和 字符 串 流 


wxMemorylnputStream 和 wxMemoryOutputStream 使 用 内 部 缓冲 区 来 处 理 流 数据 .默认 的 构造 
函数 都 采用 char 类 型 的 缓冲 区 指针 和 缓冲 区 大 小 作为 参数 .如 果 没 有 这 些 参 数 , 则 表明 要 求 该 
类 的 事例 自己 进行 动态 缓冲 区 管理 .我 们 很 快 会 看 到 一 个 相关 的 例子 . 


wxStringlnputStream 则 采用 一 a | 用 作为 构造 参数 来 进行 数据 读 取 . 
wxStringOutputStream 采 用 一 个 开 选 的 wxString 指 针 作为 参数 来 进行 数据 写 操 作 ; 如 果 构 造 参 
数 没有 指示 wxString 指 针 , 则 We 
来 访问 . 


SAGE RH 


到 目前 为 止 ,我 们 描述 的 流 类 型 都 处 理 的 是 原始 的 字 节 流 数据 .在 实际 的 应 用 程序 中 ,这 些 字 节 流 

必须 被 赋予 特定 的 函数 .为 了 帮助 你 实现 这 一 点 ,你 可 以 使 用 下 面 四 个 类 来 以 一 个 更 高 的 层级 处 
理 数据 .这 四 个 类 分 别 是 :wxTextIinputStream, wxTextOutputStream, wxDatalnputStream 和 
wxDataOutputStream. 这 些 类 通过 别 的 流 类 型 类 构造 ,它们 提供 了 操作 更 高 级 的 C++ 数据 类 型 
的 方法 . 


wxTextlnputStream 从 一 段 人 类 可 读 的 文本 中 获取 数据 .如 果 你 使 用 的 构造 类 为 文件 相关 类 ,你 
需要 自己 进行 文件 是 否 读 完 的 判断 .即使 这 样 , 读 到 空 数据 项 (长 度 为 0 的 字符 串 或 者 数字 0) 还 是 
无 法 避免 ,因为 很 多 文本 文件 都 用 空白 符 ( 比 如 换行 符 ) 来 结束 .下 面 的 例子 演示 了 怎样 使 用 由 


wxFilelnputStream 构 造 的 wxTextlnputStream: 


wxFileInputStream input( wxT("mytext.txt") ) 
wxTextInputStream text( input ); 
wxUint8 i1; 





float f2; 

wxString line; 

text &gt;&gt; il; // 读 一 个 8bit 整 数 . 

text &gt;&gt; il &gt;&gt; f2; // 先 读 一 个 8bit 整 数 再 读 一 个 浮 点 数 ， 
text &gt;&gt; line; // 读 一 行文 本 


wxTextOutputStream 则 将 文本 数据 写 至 输出 流 ,换行 符 自动 使 用 当前 平台 的 换行 符 .下 面 的 例子 
演示 了 将 文本 数据 输出 到 标准 错误 输出 流 : 


#include "wx/wfstream.h" 

#include "wx/txtstrm.h" 

wxFFileOutputStream output( stderr ); 
wxTextOutputStream cout( output ); 

cout &lt;&lt; wxT("This is a text line") &lt;&lt; endl; 
cout &lt;&lt; 1234; 

cout &lt;&lt; 1.23456; 


wxDatalnputStream 和 wxDataOutputStream 使 用 发 放 类 似 ,但 是 它 使 用 二 进 制 的 方法 义理 数据 . 
数据 使 用 可 移植 的 方式 存储 因此 能 够 作 到 平台 无 关 . 下 面 的 例子 分 别 演示 了 以 这 种 方式 从 数据 
文件 读 取 以 及 写 入 数据 文件 . 


#include "wx/wfstream.h" 

#include "wx/datstrm.h" 

wxFileInputStream input( wxT("mytext.dat") ); 
wxDataInputStream store( input ); 

wxUint8 i1; 


float f2; 

wxString line; 

store &gt;&gt; il; // 读 取 一 个 8bit 整 数 

store &gt;&gt; il &gt;&gt; f2; // 读 取 一 个 8bit 整 数 ,然后 读 取 一 个 浮 点 数 . 
store &gt;&gt; line; // 读 取 一 行文 本 


#include "wx/wfstream.h" 

#include "wx/datstrm.h" 

wxFileOutputStream output(wxT("mytext.dat") ); 
wxDataOutputStream store( output ); 

store &lt;&lt; 2 &lt;&lt; 8 &lt;&lt; 1.2; 
store &lt;&lt; wxT("This is a text line") ; 


Socket 流 


wxSocketOutputStream 和 wxSocketlnputStream 是 通过 wxSocket 对 象 构 造 的 ,详情 参见 第 18 


TE 


章 . 
过 滤器 流 对 象 
wxFilterlnputStream 和 wxFilterOutputStream 是 过 滤器 流 对 象 的 基 类 ,过 滤器 流 对 象 是 一 种 特殊 


的 流 对 象 ， 它 的 流 对 象 .wxZliblnputStream 是 一 个 典型 的 过 滤器 
流 对 象 .如 果 你 在 其 构造 画 数 中 指 定 一 个 文件 源 为 一 个 zlib 格 式 的 压缩 文件 的 文件 流 对 象 ,你 可 


以 直接 从 wxZliblnputStream 中 读 取 数据 而 不 需要 关心 解压 缩 的 机 制 .类 似 的 ,你 可 以 使 用 一 
wxFileOutputStream 来 构造 一 个 wxZlibOutputStream 对 象 ,如 果 你 将 数据 写 入 
wxZzlibOutputStream 对 象 ,压缩 后 的 数据 将 被 写 人 对 应 的 文件 中 . 


下 面 的 例子 演示 了 怎样 将 一 段 文 本 压缩 以 后 存放 人 另外 一 个 缓冲 区 中 : 


#include "wx/mstream.h" 

#include "wx/zstream.h" 

const char* buf = 
"Q1234567890123456789012345678901234567890123456789"; 

// 创建 一 个 写 入 wxMemoryoOutputStream 对 象 的 wxZLiboutputStream 类 

wxMemoryOutputStream memStreamOut; 

wxZlibOutputStream zStreamOut (memStreamOut ) ; 

// 压缩 buf 以 后 宇和 人 wxMemoryOutputStream 

zStreamOut.Write(buf, strlen(buf)); 

/ 获取 写 入 的 大 小 

int sz = memStreamOut.GetSize(); 

// 分 配合 适 大 小 的 缓冲 区 

// 拷贝 数据 

unsigned char* data = new unsigned char[sz]; 

memStreamOut.CopyTo(data, sz); 


Zip 流 对 象 


wxZiplInputStream 是 一 个 更 复杂 一 点 的 流 对 象 ,因为 它 是 以 文档 的 方式 而 不 是 线性 的 二 进 制 数 
据 的 方式 工作 的 .事实 上 ,文档 是 通过 另外 的 类 wxArchiveClassFactory 和 wxArchiveEntry 来 处 理 
的 ,但 是 你 可 以 不 用 关心 这 些 细节 .要 使 用 wxZiplnputStream 类 ,你 可 以 有 两 种 构造 方法 ,一 种 是 
直接 使 用 一 个 指向 zip 文 件 的 文件 流 对 象 ,另外 一 种 方法 则 是 通过 一 个 zip 文 件 路 径 和 一 个 zip 文 
件 中 文档 的 路 径 来 指定 一 个 zip 数 据 流 . 下 面 的 例子 演示 了 这 两 种 方法 : 


#include "wx/wfstream.h" 

#include "wx/zipstrm.h" 

#include "wx/txtstrm.h" 

// 方法 一 : 以 两 步 方式 创建 zip 输 入流. 
wxZipEntry* entry; 

wxFFileInputStream in(wxT("test.zip")); 
wxZipInputStream zip(in); 
wxTextInputStream txt(zip); 

wxString data; 

while (entry = zip.GetNextEntry()) 


wxString name = entry->GetName(); // 访问 元 数据 
txt &gt;&gt; data; // 访问 数据 
delete entry; 


} 

// 方法 二 : 直接 指定 源 文 档 路 径 和 内 部 文件 路 径 . 

wxZipInputStream in(wxT("test.zip"), wxT("text.txt")); 
wxTextInputStream txt(zip); 

wxString data; 

txt &gt;&gt; data; // 访问 数据 


wxZipOutputStream 用 来 写 zip 压 缩 文 件 . PutNextEntry 或 PutNextDirEntry 函 数 用 来 在 丰 缩 文件 
中 创建 一 个 新 的 文件 (目录 ), 然 后 就 可 以 写 相 应 的 数据 了 .例如 : 


#include "wx/wfstream.h" 

#include "wx/zipstrm.h" 

#include "wx/txtstrm.h" 
wxFFileOutputStream out(wxT("test.zip")); 
wxZipOutputStream zip(out); 
wxTextOutputStream txt(zip); 
Zip.PutNextEntry(wxT("entry1.txt")); 

txt &1t;&lt; wxT("Some text for entry1\n"); 
Zip.PutNextEntry(wxT("entry2.txt")); 

txt &1t;&lt; wxT("Some text for entry2\n"); 


虚拟 文件 系统 


wxWidgets 提 供 了 一 套 虚 拟 文件 系统 机 制 ,让 你 的 应 用 程序 可 以 象 使 用 普通 文件 那样 使 用 包括 
zip 文 件 中 的 文件 ,内 存 文件 以 及 HTTP 或 FTP 协 议 这 样 的 特殊 数据 .不 过 ,这 种 虚拟 文件 机 制 通常 
是 只 读 的 ,意味 着 你 不 可 以 修改 其 中 的 内 容 .wxWidgets 提 供 的 wxHtmlWindow 类 (用 于 提供 
wxWidgets 内 部 的 HTML 帮 助 文件 的 显示 ) 和 wxWidgets 的 XRC 资 源 文件 机 制 都 可 以 识别 虚拟 文 
件 系统 路 径 格 式 . 虚 拟 文件 系统 的 使 用 比 起 前 面 介绍 的 zip 文 件 流 要 简单 ,但 是 后 者 可 以 更 改 zip 
文档 的 内 容 .除了 内 部 都 使 用 了 流 机 制 以 外 ,这 两 者 其 实 没有 任何 其 它 的 联系 . 


各 种 不 同 的 虚拟 文件 系统 类 都 继承 自 wxFileSystemHandler 类 ,要 在 应 用 程序 中 使 用 某 个 特定 
实现 ,需要 在 程序 的 某 个 地 方 (通常 是 OnInit 函 数 中 ) 调 用 wxFileSystem::AddHandler 画 数 .使 用 
虚拟 文件 系统 通常 只 需要 使 用 那些 定义 在 wxFileSystem 对 象 中 的 函数 ,但 是 有 些 虚拟 文件 系统 
的 实现 也 提供 了 直接 给 用 于 使 用 的 函数 ,比如 wxMemoryFSHandlers 的 AddFile 和 RemoveFile 
EJZ. 
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它 子 系统 中 使 用 虚拟 文件 系统 .下 面 的 例子 演示 了 怎样 在 用 于 在 wxHtmlWindow 中 显示 的 HTML 
文件 中 使 用 指定 虚拟 文件 系统 中 的 路 径 : 


<img src="file:myapp.bin#zip:images/logo.png"> 


"#" 号 前 面 的 部 分 是 文件 名 ,后 面 的 部 分 则 是 虚拟 文件 系统 类 型 以 及 文件 在 虚拟 文件 系统 中 的 路 


4 
径 . 


类 似 的 ,我 们 也 可 以 在 XRC 资 源 文 件 中 使 用 虚拟 文件 系统 : 


<object class="wxBitmapButton"> 
<bitmap>file:myapp.bin#zip:images/fuzzy.gif</bitmap> 
</object> 


在 上 面 的 这 些 用 法 中 ,操作 虚拟 文件 系统 的 代码 被 隐藏 在 wxHtmlIWindow 和 XRC 系 统 的 实现 中 . 
如 果 你 希望 直接 使 用 虚拟 文件 系统 , 通常 你 需要 通过 wxFileSystem 和 wxFSFile 类 .下 面 的 代码 
演示 了 怎样 从 虚拟 文件 系统 中 加 载 一 幅 图 片 , 当 应 用 程序 初始 化 的 时 候 , 增 加 一 个 

wxZipFSHandler 类 型 的 虚拟 文件 系统 处 理 器 .然后 创建 一 个 wxFileSystem 的 实例 ,这 个 实例 可 
以 是 临时 使 用 也 可 以 存在 于 整个 占用 程序 的 生命 周期 ,这 个 实例 用 来 从 zip 文 件 myapp.bin 中 获 


取 logo.png 图 片 .wxFSFile 对 象 用 于 返回 


wxlmage 对 象 .在 这 
被 释放 了 . 


#include "wx/fs_zip.h" 

#include "wx/filesys.h" 
#include "wx/wfstream.h" 
// 这 一 行 代码 只 


这 个 文件 对 应 的 数据 流 ,然后 通过 流 的 方式 创建 
个 对 象 被 转换 成 wxBitmap 格 式 以 后 ,wxFSFile 和 wxFileSystem 对 象 就 可 以 


应 该 被 执行 依次 , 最 好 是 在 应 用 程序 初始 化 的 时 候 


wxFileSystem: :AddHandler (new wxZipFSHandler ); 


wxFileSystem* 


fileSystem = new wxFileSystem; 


wxString archive = wxT("file:///c:/myapp/myapp.bin"); 
wxString filename = wxT("images/logo.png"); 


wxFSFile* file = fileSystem->OpenFile( 
archive + wxString(wxT("#zip:")) + filename); 
if (file) 
wxInputStream* stream = file->GetStream(); 


wxImage image(* stream, 
delete file; 


} 
delete fileSystem; 


注意 要 使 用 wxFileSystem:: OpenFile 函 数 , 其 参数 必须 是 一 个 URL 而 不 能 是 一 个 绝对 路 径 


bitmapType); 
wxBitmap bitmap = wxBitmap(image); 


式 应 该 为 "file:/< 主 机 名 >//< 文 件 名 >", 如 果 主 机 名 为 空 , 则 使 用 三 个 "/" 符 号 .你 可 以 使 用 
wxFileSystem::FileNameToURL 图 数 获取 某 个 文件 对 应 的 URL, 也 可 以 用 
wxFileSystem::URLToFileName 画 数 将 某 个 URL 转 换 成 对 应 的 文件 名 . 


下 面 的 例子 演示 了 TAR 


获取 虚拟 文件 系统 中 获 


一 个 文本 文件 的 内 容 ,并 将 其 存放 在 某 个 


wxString 对 象 中 ee 中 的 虚拟 文件 的 路 径 : 


// 从 zip 文 件 中 加 载 一 个 文本 文件 


bool LoadTextResource(wxString& text, 


const wxString& archive, 


const wxString& filename) 


{ 


wxString archiveURL(wxFileSystem: 


:FileNameToURL(archive) ); 
fileSystem = new wxFileSystem; 


archiveURL + wxString(wxT("#zip:")) + filename); 


wxFileSystem* 
wxFSFile* file = fileSystem->OpenFile( 
if (file) 
{ 
wxInputStream* stream = 


buf[sz] = 

text = wxString: 
delete[] buf; 
delete file; 
delete fileSystem; 
return true; 


else 
return false; 


file->GetStream(); 
size_t sz = stream->GetSize(); 
char* buf = new char[sz + 1]; 
stream->Read((void*) buf, 


:FromAscii(buf); 


,其 格 


wxMemoryFSHandler 人 允许 你 将 数据 保存 在 内 存 中 并 且 通 过 内 存 协 议 在 虚拟 文件 系统 中 使 用 它 . 
显然 在 内 存 中 存放 大 量 数据 并 不 是 一 个 值得 推荐 的 作法 ,不 过 有 时 候 却 可 以 给 应用 程序 提供 一 
定 程序 的 灵活 性 ,比如 你 正在 使 用 只 读 的 文件 系统 或 者 说 使 用 磁盘 文件 存在 性 能 上 的 问题 的 时 
候 .在 DialogBlocks 软 件 中 ,如 果 用 户 提供 的 自 定义 图 标 文 件 还 不 具 各 ,DialogBlocks 仍 然 可 以 通 
过 下 面 的 XRC 文 件 显示 一 个 内 存 中 的 图 片 , 这 个 图 片 并 不 存在 于 任何 的 物理 磁盘 中 . 


<object class="wxBitmapButton"> 
<bitmap&gt;memory:default.png</bitmap> 
</object> 


wxMemoryFSHandler 的 AddFile 画 数 可 以 使 用 的 参数 包括 一 个 虚拟 文件 名 和 一 个 wxlImage,， 
wxBitmap, wxString 或 void* 数 据 . 如 果 你 不 再 使 用 某 个 内 存 虚 拟 文件 了 ,可 以 通过 RemoveFile 
函数 将 其 删除 .如 下 所 示 : 


#include "wx/fs_mem.h" 

#include "wx/filesys.h" 

#include "wx/wfstream.h" 

#include "csquery.xpm" 

wxFileSystem: :AddHandler(new wxMemoryFSHandl1er ) ; 

wxBitmap bitmap(csquery_xpm); 

wxMemoryFSHandler: :AddFile(wxT("csquery.xpm"), bitmap, 
wxBITMAP_TYPE_XPM); 


wxMemoryFSHandler: :RemoveFile(wxT("csquery.xpm") ); 


wxWidgets 支 持 的 第 三 种 虚拟 文件 系统 是 wxlnternetFSHandler, 它 支持 FTP 和 HTTP 协 议 . 


第 十 四 章 小 结 


本 章 介 绍 了 怎样 使 用 wxWidgets 提 供 的 跨 平 台 的 文件 和 流 操作 相关 的 类 .还 介绍 了 wxWidgets 
中 的 虚拟 文件 系统 机 制 , 它 可 以 让 你 很 方便 的 访问 位 于 zip 文 件 ,内 存 或 者 Internet 上 的 文件 . 


在 下 一 章 里 ,我 们 将 介绍 一 些 你 的 最 终 用 户 可 能 不 会 直接 看 到 但 是 却 仍然 非常 重要 的 话题 :内 存 
管理 ,调试 和 错误 检测 . 


第 十 五 章 内 存 管 理 ,调试 和 错误 义理 


本 章 用 来 介绍 wxWidgets 提 供 的 用 来 检测 内 存 问题 的 机 制 .同时 也 涉及 了 一 些 构建 更 可 靠 和 更 
容易 调试 的 应 用 程序 的 内 容 ,比如 怎样 构建 具有 自 防御 功能 的 程序 .我 们 还 将 解释 什么 时 候 应 该 
在 堆 上 创建 对 象 ,什么 时 候 则 应 该 在 栈 上 创建 对 象 ,以 及 怎样 使 用 运行 期 类 型 信息 机 制 ,模块 机 制 
以 及 wxWidgets 提 供 的 C++ 异 常 支持 等 .最 后 ,我 们 会 提供 一 些 通用 的 调试 方法 提示 . 


15.1 内 存 管理 基础 


和 大 多 数 的 C++ 程序 一 样 ,你 可 以 在 栈 上 创建 对 象 ,也 可 以 在 堆 上 通过 new 来 创建 对 象 .前 者 的 生 
命 周期 仅 限于 其 作用 范围 ,当代 码 离开 其 作用 范围 时 ,对 象 的 析 构 范 数 被 调用 ,对 象 被 释放 .而 堆 
上 的 对 象 则 相反 , 它 将 一 直 存在 除非 你 使 用 delete 操 作 释 放 对 象 或 者 整个 应 用 程序 退出 . 


创建 和 释放 窗口 对 象 


一 个 通用 的 规则 是 : 想 frame 或 者 按钮 这 样 的 窗口 对 象 总 是 应 该 在 堆 上 使 用 new 方 法 创建 .因为 
窗口 对 象 通常 有 一 个 不 确定 的 生命 周期 .或 者 说 ,窗口 对 象 通常 要 等 用 户 决定 什么 时 候 关 闭 并 且 
释放 自己 .注意 wxWidgets 会 自动 释放 子 窗口 ,因此 你 只 需要 调用 顶层 窗口 的 Destroy 郴 数 ,而 不 
需要 依次 调用 窗口 中 其 它 控件 的 Destroy 男 数 . 类 似 的 ,在 被 释放 的 时 候 ,frame 窗 口 也 会 自动 释放 
它 的 所 有 的 子 窗口 .不 过 如 果 你 创建 了 一 个 作为 fame 窗 口子 窗口 的 顶层 窗口 (比如 另外 一 个 
frame), 这 个 子 窗口 将 不 会 被 自动 释放 .这 又 有 一 个 例外 ,在 MDI( 多 文档 界面 ) 中 , 子 文档 窗口 将 被 
自动 释放 ,因为 它们 其 实 是 主 文档 窗口 的 一 部 分 ,是 不 应 该 独立 存在 的 . 


你 可 以 在 栈 上 创建 对 话 框 窗口 ,但 是 它 必须 是 模式 对 话 框 . 换 句 话说 ,你 必须 使 用 ShowModal 函 
数 使 其 进入 一 个 事件 循环 ,所 有 的 和 用 户 的 交互 都 将 在 这 个 事件 循环 中 被 处 理 ,并 且 这 些 交 互 都 
发 生 在 对 话 框 离开 其 作用 域 从 而 被 释放 之 前 . 


释放 frame 窗 口 和 对 话 框 窗口 的 方法 也 许 让 你 感到 困惑 ,我 们 进一步 解释 一 下 .要 释放 frame 窗 口 
或 者 非 模 式 对 话 框 ,应 用 程序 应 该 调用 Destroy 函 数 ,这 个 琅 数 在 相关 对 话 框 的 事件 队列 变 空 以 
后 才 会 释放 窗口 ,否则 可 能 将 事件 发 送 到 不 存在 的 窗口 导致 程序 异常 .然而 对 于 模式 对 话 框 来 说 ， 
应 该 首先 调用 EndModal 函 数 退 出 窗口 的 事件 循环 .这 个 画 数 通常 是 在 对 话 框 的 事件 处 理事 数 中 
被 调用 的 ,比如 默认 的 OK 按钮 事件 处 理 画 数 .在 事件 处 理 画 数 中 只 能 调用 EndModal 而 不 能 调用 
Destroy, 因 为 模式 对 话 框 很 可 能 是 在 栈 上 创建 的 ,如 果 在 事件 处 理事 数 中 调用 Destroy, 很 可 能 
致 这 个 对 话 框 被 重复 释放 (一 次 是 在 事件 处 理 画 数 中 ,一 次 是 在 柜 变 量 退 出 其 作用 域 时 ) 导 致 冰 
用 程序 表现 异常 .因此 ,正确 的 处 理 顺 序 是 : 当 用 户 点 击 关 闭 按钮 时 ,产生 
wxEVT_CLOSE_WINDOW 事 件 ,这 个 事件 的 处 理 琅 数 调 用 EndModal 函 数 ( 而 不 是 Destroy 画 
数 ). 而 对 话 框 则 可 以 在 其 退出 作用 域 的 时 候 被 自动 释放 ,这 也 是 所 有 wxWidgets 提 供 的 标准 对 话 
框 采 用 的 方式 .这 种 方式 的 另外 一 个 好 处 在 于 , 当 调 用 EndModal 函 数 退 出 事件 循环 以 后 , 你 还 可 
以 访问 对 话 框 变量 的 公共 成 员 以 便 获取 相应 的 数据 .当然 你 也 可 以 设计 直接 在 其 事件 处 理 范 数 
中 释放 自己 的 对 话 框 ,不 过 对 于 这 种 对 话 框 ,你 就 不 能 够 在 栈 上 创建 它 并 且 也 不 可 以 在 它 被 关闭 
以 后 还 可 以 访问 它 的 公共 成 员 了 . 


下 面 演示 的 两 种 使 用 wxMessageDialog 的 方法 都 是 允许 的 : 


// 1) 在 栈 上 创建 模式 对 话 框 ,没有 显 式 的 释放 函数 
wxMessageDialog dialog(NULL, _("Press OK"), _("App"), wxOK|wxCANCEL); 
if (dialog.ShowModal() == wxID_OK) 


// 2) 创建 在 堆 上 的 模式 对 话 框 , 必须 使 用 Destroy 显 式 删 除 

wxMessageDialog* dialog = new wxMessageDialog(NULL, 
_("Thank you! "), _("App"), wx0K); 

dialog->ShowModal(); 

dialog->Destroy(); 


非 模 式 对 话 框 和 frame 窗 口 通 常 需要 在 关闭 的 时 候 释 放 自 己 ,关闭 动作 可 以 通过 各 种 方式 产生 . 
它们 不 能 在 栈 上 创建 ,因为 它们 通常 会 很 快 离开 自己 的 作用 范围 ,将 被 立即 释放 . 


如 果 你 使 用 了 指向 窗口 对 象 的 指针 ,需要 确定 在 窗口 被 释放 以 后 ,指针 被 置 为 NULL, 这 可 以 在 窗 
口 的 析 构 函数 或 者 关闭 事件 处 理 画 数 中 完成 ,如 下 所 示 : 


void MyFindReplaceDialog: :OnClosewindow(wxCloseEvent& event) 


wxGetApp().SetFindReplaceDialog(NULL) ; 
Destroy(); 
} 


创建 和 复制 绘画 对 象 


绘画 过 程 中 使 用 的 对 象 ,比如 wxBrush, wxPen, wxColour, wxBitmap 和 wxlmage 等 , 既 可 以 在 堆 
上 创建 也 可 以 在 栈 上 创建 .这 些 对 象 在 绘画 函数 中 使 用 时 通常 在 栈 上 创建 (局 部 变量 ). 这 些 对 象 
内 部 使 用 引用 记 数 机 制 ,因此 直接 使 用 对 象 (而 不 是 对 象 指 针 ) 的 系统 开销 也 是 非常 小 的 .这 种 机 
制 的 具体 作法 是 :在 进行 赋值 或 复制 操作 的 时 候 , 只 复制 对 象 内 部 数据 的 一 个 引用 而 不 是 整个 的 
内 部 数据 .当然 这 种 机 制 有 时 候 也 会 导致 一 些 奇怪 的 问题 ,比如 某 个 对 象 的 修改 导致 所 有 引用 该 
对 象 的 对 象 的 修改 .为 了 避免 这 种 情况 ,在 需要 的 时 候 , 你 可 以 通过 在 构造 画 数 中 传递 具体 的 参数 
来 构造 一 个 全 新 的 对 象 .下 面 各 自 举 一 些 例子 : 


// 引用 记 数 

wxBitmap newBitmap = oldBitmap; 

// 全 新 拷贝 

wxBitmap newBitmap = oldBitmap.GetSubBitmap( 
wxRect(0, ©, oldBitmap.GetWidth(), oldBitmap.GetHeight())); 

// 引用 记 数 

wxFont newFont = oldFont; 

// 全 新 拷贝 

wxFont newFont(oldFont.GetPointSize(), oldFont.GetFamily(), 
oldFont.GetStyle(), oldFont.GetWeight(), 
oldFont.GetUnderlined(), oldFont.GetFaceName()); 


初始 化 你 的 应 用 程序 中 的 对 象 


为 你 的 自 定义 对 象 可 能 先 于 wxWidgets 自 己 的 初始 化 而 被 创建 ,有 可 能 在 你 的 自 定义 对 象 初 
始 化 的 时 候 ,wxWidgets 的 内 部 数据 包括 颜色 数据 库 ,字体 数据 库 等 都 还 没有 被 初始 化 ,因此 ,不 
要 在 你 的 自 定义 应 用 程序 类 的 构造 男 数 中 使 用 wxwidgets 的 预定 义 值 初始 化 你 的 对 象 ,如 果 你 需 
要 使 用 这 些 值 ,可 以 在 Onlnit 函 数 中 进行 .举例 如 下 : 


MyApp: :MyApp() 


// 不 要 在 这 个 时 候 作 初始 化 
// m font = *wxNORMAL_FONT; 


} 
bool MyApp: :OnInit() 
m_font = *wxNORMAL_FONT; 


return true; 


在 应 用 程序 退出 时 执行 清理 


你 可 以 在 重 载 的 wxApp::OnExit 芳 数 中 执行 大 多 数 的 清理 工作 ,这 个 函数 是 在 所 有 的 窗口 都 已 经 
被 释放 ,wxWidgets 正 准 各 释放 自己 的 内 部 数据 的 时 候 被 调用 的 .不 过 有 些 清理 工作 还 是 需要 在 
主 窗口 的 关闭 事件 义理 函数 中 执行 ,比如 关闭 那些 可 能 往 主 窗口 发 送 数据 的 进程 . 


15.2 检测 内 存 泄漏 和 其 它 错 误 


在 理想 状态 下 , 当 你 的 应 用 程序 退出 时 ,所 有 的 对 象 都 应 该 被 你 的 应 用 程序 或 者 wxWidgets 本 身 
释放 ,不 会 有 残留 的 内 存 需要 操作 系统 自己 去 释放 .不 用 关心 内 存 的 释放 听 上 去 似乎 非常 的 诱 人 , 
但 是 ,我 们 还 是 要 说 ,你 应 该 自己 控制 所 有 对 象 的 释放 ,而 不 要 把 它 留 给 操作 系统 ,因为 通常 ,内 存 
泄漏 都 是 一 些 其它 重 大 问题 的 前 兆 , 它 可 能 导致 你 的 系统 在 一 段 时 间 内 出 现 严重 的 内 存 问题 .而 
当 你 已 经 转 而 关注 程序 的 其 它 方面 的 时 候 , 会 过 头 来 研究 哪里 出 现 了 港 漏 是 一 件 非 常 全 人 泪 丧 
的 事情 ,因此 ,让 你 的 程序 尽量 保持 对 内 存 泄漏 的 需 容 忍 度 不 是 一 个 坏事 . 


那么 ,怎样 才 可 能 让 你 的 应 用 程序 拥有 这 种 检测 内 存 泄漏 的 能 力 呢 ?各 种 各 样 的 第 三 方 工具 提供 
了 这 种 能 力 甚 至 更 多 其 它 的 能 力 ,而 且 , wxWidgets 也 提供 了 一 个 自己 的 简单 的 内 建 的 内 存 检测 
器 .如 果 你 想 使 用 它 ,在 windows 平 台 上 ,你 需要 打开 setup.h 中 的 几 个 开关 ,而 在 linux 平台 

上 ,configure 程 序 需要 一 些 特殊 的 开关 : 


在 windows 平 台 上 ,你 需要 : 


#define wxUSE_DEBUG_CONTEXT 1 

#define wxUSE_MEMORY_TRACING 1 

#define wxUSE_GLOBAL_MEMORY_OPERATORS 1 
#define wxUSE_DEBUG_NEW_ALWAYS 1 





而 对 于 configure 程 序 ,需要 传递 这 样 的 参数 : 


--enable-debug --enable-mem_tracing --enable-debug_cntxt 


另外 ,使 用 这 个 系统 还 有 一 个 限制 :到 作者 停 笔 之 前 , 它 还 不 支持 MinGW 或 Cygwin 编 译 器 ,并 且 如 
果 你 的 代码 中 使 用 了 STL 或 者 使 用 CodeWarrior 编 译 器 ,你 将 不 能 使 用 
wxUSE_DEBUG_NEW_ALWAYS 选 项 . 


如 果 打 开 了 wxUSEDEBUGNEWALWAYS 选 项 ,那么 所 有 使 用 new 操 作 分 配对 象 的 地 方 都 将 被 
new 人 LTFILE， /LINE) 代 蔡 , 后 者 已 经 被 重新 使 用 调试 版 本 的 定制 内 存 分 配 和 释放 机 制 进行 实 
现 .如 果 想 不 重新 定义 new 而 显 式 使 用 调试 版 本 的 new 过 程 ,你 可 以 在 使 用 new 的 地 方 用 
WXDEBUG_NEW 代 蔡 . 


最 简单 的 使 用 这 个 系统 的 方法 是 :什么 都 不 做 ,就 只 运行 你 的 程序 , 作 该 做 的 事情 ,然后 退出 应 用 
程序 ,然后 检查 是 否 有 任何 内 存 港 漏 被 报告 .下 面 的 内 存 泄漏 报告 的 一 个 例子 : 


There were memory leaks. 


- Memory dump - 

.\memcheck.cpp(89): wxBrush at OxBE44B8, size 12 
..\..\src\msw\brush.cpp(233): non-object data at OxBE55A8, size 44 
.\memcheck.cpp(90): wxBitmap at OxBE5088, size 12 
..\..\src\msw\bitmap.cpp(524): non-object data at OxBE6FB8, size 52 
.\memcheck.cpp(93): non-object data at OxBB8410, size 1000 
.\memcheck.cpp(95): non-object data at OXBE6F58, size 4 
.\memcheck.cpp(98): non-object data at OXxBE6EF8, size 8 


- Memory statistics - 

1 objects of class wxBitmap, total size 12 
objects of class nonobject, total size 1108 
1 objects of class wxBrush, total size 12 


ol 


Number of object items: 2 
Number of non-object items: 5 
Total allocated size: 1132 


上 面 的 例子 显示 有 一 个 wxBrush 对 象 和 一 个 wxBitmap 对 象 被 分 配 了 但 是 没有 被 释放 ,还 有 一 些 
其 它 的 未 知 的 对 象 没 有 被 释放 ,因为 它们 没有 提供 wxWidgets 的 运行 期 类 型 信息 ,因此 无 法 确定 
对 象 的 类 型 .在 某 些 集成 开发 环境 中 ,你 可 以 通过 双击 报告 行 显示 相应 的 代码 中 分 配 这 个 对 象 的 
位 置 ,这 通常 是 检查 内 存 泄漏 问题 一 个 很 好 的 开始 .当然 ,为 了 最 好 的 报告 效果 ,最 好 给 任何 继承 

自 wxObject 都 提供 运行 期 类 型 信息 ,方法 是 ,在 类 声明 的 部 分 增加 DECLARE_CLASS(class) 宏 ， 
在 类 实现 的 地 方 增加 IMPLEMENT_CLASS(class, parentClass) 宏 


个 内 存 检测 系统 还 试图 检测 那些 内 存 越界 或 重复 释放 的 错误 .在 分 配 内 存 的 时 候 , 它 自动 在 已 
ean 置 一 个 "good" 标 记 , 在 释放 的 时 候 将 会 检查 这 个 标记 ,如 果 释放 的 内 存 块 没 
有 这 个 标记 , 则 报告 一 个 内 存 释放 错误 .这 将 帮助 你 发 现 那 些 隐藏 的 ,也 许 在 多 次 运行 以 后 才 会 导 
致 系统 异常 的 内 存 错误 . 


wxDebugContext 类 的 一 些 静态 函数 也 很 有 用 义 ,你 可 以 通过 PrintClasses 画 数 获取 当前 系统 中 
分 配 的 对 象 的 列表 , PrintStatistics 函 数 可 以 打印 出 当前 系统 中 的 已 知 类 型 对 象 和 未 知 类 型 对 象 
的 个 数 .使 用 SetCheckpoint 画 数 ,你 可 以 告诉 wx<DebugContext 忽 上 略 这 个 函数 调用 以 前 的 内 存 
分 配 动作 ,而 仅 关 注 这 以 后 的 内 存 分 配 .详情 请 参考 samples/memcheck 例 子 或 者 
wxDebugContext 的 相关 手册 . 


除了 wxWidgets 内 建 的 基本 系统 ,你 还 可 以 使 用 别 的 商业 的 或 者 免费 的 内 存 检测 软件 ,商业 软件 
比如 :BoundsChecker, Purify 或 AQtime 等 .自由 软件 比如 :StackWalker,ValGrind,Electric Fence 
或 来 自 Fluid Studios 的 MMGR 等 .如 果 你 使 用 的 是 Visual C++,wxWidgets 使 用 的 是 编译 器 内 置 
的 内 存 检测 机 制 , 它 不 会 给 出 类 的 名 字 但 是 会 给 出 行 号 .最 好 是 打开 

WxXUSE_DEBUG NEW_ALWAYS 选 项 ,因为 它 将 重 定 义 new 过 程 ,除非 打开 这 个 选项 导致 别 的 
第 三 方 的 库 出 现 兼 容 方面 的 问题 . 
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通常 一 个 缺陷 在 导致 其 产生 的 逻辑 错误 产生 很 久 以 后 才 会 表现 出 来 .如 果 一 个 异常 的 或 者 不 正 
确 的 值 没有 被 及 时 检测 到 ,那么 通常 在 应 用 程序 又 执行 了 几 千 行 代码 以 后 ,应 用 程序 才 会 崩溃 或 
者 作出 倒 人 费解 的 表现 .为 解决 这 样 的 问题 你 可 能 要 花 上 很 长 的 时 间 . 但 是 ,如 果 你 在 你 的 代码 中 
增加 一 些 普通 的 检查 ,来 检测 函数 的 某 个 地 方 出 现 了 错误 的 值 ,那么 你 的 代码 将 最 终 变 得 非常 强 
壮 , 你 将 可 能 避免 你 和 你 的 用 户 陷入 到 大 麻烦 中 去 .这 就 是 所 谓 的 自 防御 程序 .你 的 代码 可 以 防止 
自己 被 别 的 代码 或 者 自己 内 部 的 某 些 错误 逻辑 搞 的 一 团 粮 . 因 为 大 多 数 的 这 些 检测 在 正式 发 布 
版 中 都 将 被 移 除 ,因此 ,它们 占用 的 系统 开销 几乎 可 以 忽略 不 计 . 


正如 你 期 待 的 那样 ,wxWidgets 在 其 内 部 使 用 了 大 量 的 错误 检测 代码 ,你 可 以 在 你 的 代码 中 直接 
使 用 这 些 宏 . 这 些 宏 主要 分 为 三 类 ,每 一 类 都 有 多 种 形式 :第 一 类 是 wxASSERT, 如 果 它 的 参数 不 
等 于 True, 它 将 显示 一 个 错误 信息 .这 种 检测 仅 存 在 于 调试 版 本 中 .wxFAIL 则 将 使 用 产生 一 个 错 
误 信息 ,其 作用 相当 于 wxASSERT(false). 它 也 仅 会 存在 于 调试 版 本 中 .wxCHECK 则 判断 条 件 是 
否 成 立 , 如 果 不 成 立 则 返回 某 个 值 并 显示 错误 信息 .和 前 面 两 种 不 同 的 是 ,在 正式 版 本 

中 ,wxCHECK 的 代码 仍然 有 效 ,但 是 将 不 显示 任何 消息 . 


// 两 个 正 数 相 加 

int AddPositive(int a, int b) 

{ 
// 检查 是 否 为 一 个 正 数 
ee &gt; 0); 
// 检查 是 否 位 一 个 正 数 , 显示 定制 的 消息 
wxASSERT_MSG(b &gt; ©, wxT("The second number must be positive!")); 
int è= a t b; 
// 如 果 相 加 的 结果 不 为 正 数 , 显示 一 个 错误 的 消息 并 且 返 回 -1. 
wxCHECK_MSG(c &gt; ©, -1, wxT("Result must be positive!")); 
return C; 


你 还 S MSG 宏 ,这 两 个 宏 在 条 件 不 满足 的 时 候 可 以 执行 任意 
的 操作 而 不 仅仅 是 设置 一 个 返回 值 . 而 wxCHECK_RET 则 可 以 被 用 在 没有 返回 值 (void) 的 函数 
中 .另外 一 些 不 eee E wxASSERT_MIN_BITSIZE 
等 ,请 参考 wxWidgets 的 相关 手册 . 


下 图 演示 了 一 个 断言 不 满足 时 显示 消息 的 对 话 框 的 样子 ,在 这 个 对 话 框 上 有 三 个 按钮 ,Yes 按 钮 
停止 当前 程序 的 运行 ,No 按钮 则 忽略 这 个 断言 失败 ,而 Cancel 按 钮 则 表示 以 后 的 断言 失败 都 不 
需要 显示 .如 果 程 序 正 运行 在 某 个 调试 器 中 , 则 程序 终止 运行 将 返回 到 调试 器 中 ,你 可 以 打印 出 当 
前 的 函数 调用 堆栈 ,进而 可 以 知道 断言 失败 的 准确 位 置 以 及 当时 各 个 参数 的 值 . 


wxWidgets 跨 平台 GUI 编程 


wxWidgets Debug Alert 


X) thing.cpp{77}: assert "b > 0" Failed: The second number must be positive! 


Do you want to stop the program? 
You can also choose [Cancel] to suppress further warnings. 
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15.4 错误 报告 


有 时 候 你 需要 在 控制 台 或 者 一 个 对 话 框 中 显示 一 条 消息 以 帮助 调试 或 者 用 来 提示 那些 不 能 被 
你 的 代码 正常 处 理 的 行为 .wxWidgets 提 供 了 很 多 用 于 记录 错误 的 落 数 ,这 些 画 数 工 作 方 式 各 不 
相同 ,你 可 以 使 用 它们 来 进行 运行 情况 的 报告 和 记录 .比如 , 当 你 正在 分 配 一 个 很 大 的 图 片 时 ,可 
能 由 于 这 个 图 片 太 大 了 ,系统 无 法 分 配 足 够 的 资源 ,系统 将 使 用 wxLogError 函 数 显 示 一 个 对 话 框 
来 报告 这 个 错误 (如 下 图 所 示 ). 又 或 者 说 ,你 想 将 某 个 参数 的 值 打 印 在 调试 窗口 中 以 便于 调试 ,你 
可 以 使 用 wxLogDebug 画 数 .究竟 这 些 错误 信息 或 者 调试 信息 是 显示 在 终端 上 ,对 话 框 中 还 是 别 
的 什么 地 方 ,取决 于 你 所 使 用 的 函数 ,以 及 当前 激活 的 wxLog 目 标 对 象 ,我 们 将 在 稍 后 的 部 分 描述 
相关 内 容 . 


Dialogs Error 


& The top level caller detected an unrecoverable error. 


| << Details i 


iD This is some message - everything is ok so far. 17:00:44 
i) Another message this one is on multiple lines 17:00:44 
NAnd then something went wrongl 17:00:44 
[x | Intermediary error handler decided to abort. 17:00:44 
[x | The top level caller detected an unrecoverable error. 17:00:44 





所 有 的 这 种 记录 画 数 都 拥有 类 似 于 printf 或 vprintf 的 语法 ,也 就 是 :第 一 个 参数 是 格式 化 文本 参数 ， 
后 面 是 不 定 类 型 的 变量 或 者 一 组 指向 变量 的 指针 ,如 下 所 示 : 


wxString name(wxT("Calculation")); 

int nGoes = 3; 

wxLogError(wxT("%S does not compute! You have %d more goes."), 
name.c_str(), nGoes); 


下 面 我 们 逐个 描述 3x He RX: 


wxLogErrorB A FAK E ARLE 4h BA POA. RRA A eT Ht SHERI 
知 用 户 相应 的 错误 . 那 为 什么 不 直接 使 用 wxMessageBox 呢 ?原因 是 ,首先 wxLogError 提 示 的 错 
误 消 息 是 可 以 通过 创建 一 个 wxLogNull 的 Log 目 标 来 屏蔽 让 其 不 显示 出 来 的 ,而 且 这 些 消息 也 是 
排 在 系统 队列 中 ,在 系统 空闲 的 时 候 显示 的 .因此 如 果 有 一 系列 的 错误 同时 出 现 ,它们 将 显示 在 同 
一 个 对 话 框 中 ,而 如 果 使 用 wxMessageBox, 你 的 用 户 可 能 不 得 不 不 停 的 点 击 OK 按 钮 . 


wxLogFatalError 和 wxLogError 类 似 ,不 过 除了 显示 错误 消息 , 它 还 使 用 标准 的 系统 调用 abort, 以 
错误 码 3 结束 整个 程序 的 运行 .和 其 它 类 似 的 函数 不 同 ,这 个 豆 数 显示 的 消息 不 能 通过 设置 空 的 
打印 目标 的 方法 来 屏蔽 . 


wxLogWarning 也 和 wxLogError 类 似 ,不 过 显示 的 信息 将 作为 警告 而 不 是 错误 
wxLogMessage 则 用 来 显示 所 有 正常 的 ,信息 类 型 的 消息 ,默认 也 是 显示 在 对 话 框 中 . 


wxLogVerbose 则 用 来 显示 那些 见长 的 详细 信息 .通常 情况 下 ,这 种 信息 是 不 显示 的 ,但 是 如 果 用 
户 想 显示 它 以 便 了 解 程序 运行 的 更 详细 的 情况 ,可 以 通过 使 用 wxLog::SetVerbose 函 数 改 变 这 种 
默认 的 行为 . 


wxLogStatus 则 用 来 显示 状态 条 消息 ,如 果 当 前 的 ffame 窗 口 拥有 一 个 状态 条 ,那么 这 个 消息 将 显 
示 在 那里 . 


wxLogSysError 通 常 主要 被 wxWidgets 自 己 使 用 , 它 用 来 报告 那些 系统 错误 ,同时 会 显示 由 errno 
或 者 GetLastError( 依 : 示 的 错误 码 和 错误 消息 . 它 的 另外 一 种 形式 允许 你 的 第 一 
参数 的 位 置 显 式 的 指示 系统 错误 厂 


wxLogDebug 用 来 显 式 调试 信息 .这 些 信息 只 在 调试 版 本 中 (定义 了 WXDEBUG 宏 ) 才 会 出 现 ,在 
正式 版 本 中 将 被 移 除 .在 windows 平 台 上 ,只 有 当 程 序 在 一 个 调试 器 中 运行 或 者 使 用 第 三 方 工 具 
比如 来 自 http://www.sysinternals.com 的 DebugView 工 具 运 行 的 时 候 才 会 显示 出 来 . 


wxLogTrace 和 wxLogDebug 的 功能 几乎 完全 一 样 ,也 是 只 在 调试 模式 才 会 显示 信息 .之 所 以 有 这 
个 画 数 ,是 为 了 提供 一 个 和 普通 的 调试 模式 不 同 的 级 别 以 便 区 分 普通 的 调试 信息 和 用 于 跟踪 的 
调试 信息 . 它 的 另外 一 种 形式 允许 你 指定 一 个 掩 码 ,通过 wxLog:: AddTraceMask axis E T #8 
码 以 后 ,只 有 掩 码 符 合 的 跟踪 消息 才 会 被 显示 出 来 以 实现 跟踪 消息 的 过 滤 . 比 如 在 wxWidgets 内 
部 使 用 了 mousecapture 拓 码 .如 果 你 设置 了 这 个 掩 码 ,在 鼠标 移动 的 时 候 你 将 看 到 跟踪 信息 . 


void wxWindowBase: :CaptureMouse( ) 


wxLogTrace(wxT("mousecapture"), wxT("CaptureMouse(%p) "), this); 


} 
void MyApp: :OnInit() 


// Add mousecapture to the list of trace masks 
wxLog: :AddTraceMask(wxT("mousecapture") ); 


你 可 能 会 疑惑 ,为 什么 不 直接 使 用 C 的 标准 输入 输出 函数 或 者 C++ 的 流 呢 ? 简 短 的 回答 是 ,它们 都 
是 很 不 错 的 机 制 ,但 是 并 不 一 定 适 用 于 wxWidgets.wxLog 机 制 主要 有 以 下 三 个 优点 : 


首先 ,wxLog 是 可 移植 的 .常用 的 printf 语 a Aiea 
问题 的 ,但 是 在 windows 系 统 中 ,对 于 图 形 化 界面 的 应 用 程序 ,这 些 函 数 或 流 可 能 正常 显示 
需要 的 内 容 . 因 此 ,你 可 以 使 用 wxLogMessage 作 为 printf 的 一 个 简 pence 


你 也 可 以 通过 下 面 的 方法 将 所 有 的 log 信 息 转 向 标准 的 cout 流 : 


wxLog *logger=new wxLogStream(&cout); 
wxLog: :SetActiveTarget(logger); 


另外 ,将 发 送 往 cout 的 输出 重 定向 到 一 个 wxTextCtrl 控 件 也 是 可 行 的 ,这 需要 使 用 到 
wxStreamToTextRedirector # . 


— wxLog 更 灵活 .使 用 wxLog 机 制 的 输出 可 以 被 分 情况 重 定向 或 者 隐藏 ,比如 只 显示 错误 消息 
0 告警 消息 ,忽略 所 有 正常 的 信息 .而 如 果 使 用 标准 的 函数 或 流 ,这 是 不 可 能 的 或 者 说 是 很 难 作 到 
i 


最 后 :wxLog 机 制 也 是 更 完善 的 机 制 .通常 , 当 有 错误 发 生 的 时 候 , 应 该 给 用 户 显示 一 些 信息 .让 我 
们 来 举 一 个 简单 的 例子 ,假如 你 正在 进行 写 文件 操作 ,这 时 候 发 生 了 磁盘 空间 不 足 的 情况 ,这 种 错 
误 是 被 wxWidgets 内 部 (wxFile::Write) 处 理 的 ,因此 ,调用 这 个 函数 只 能 知道 写 动 作 发 生 了 异常 ， 
至 于 是 什么 类 型 的 异常 则 很 难得 到 ,如 果 在 这 种 情况 下 使 用 wxLogError 函 数 ,正确 的 错误 码 和 相 
应 的 错误 信息 都 将 显示 给 用 户 . 


现在 我 们 来 描述 以 下 wxWidgets 的 Log 机 制 是 怎样 工作 的 ,以 便 你 处 理 那 些 默认 没有 提供 的 行 
pli aaa 个 log 目 标的 概念 : 它 其 实 就 是 一 个 wxLog 的 派生 类 . 它 需 要 实现 wxLog 定 义 的 那 
些 虚 函数 ,这 些 函 数 将 在 相应 的 Log 函 数 被 调用 的 时 候 使 用 .任何 时 候 都 只 有 一 个 log 目 标 是 活动 
的 .log 目 标 通 常 的 使 用 方法 就 是 调 用 wxLog:: SetActiveTarget 来 安装 这 个 目标 ,安装 以 后 的 目标 
将 在 相应 的 log 画 数 被 调用 的 时 候 自 动 使 用 . 


要 创建 一 个 自 定义 的 log 目 标 ,你 只 需要 创建 一 个 wxLog 的 派生 类 ,并 实现 其 虚 函 数 DoLogString 
和 (或 )DoLog. 如 果 你 对 wxWidgets 默 认 的 增加 时 间 惟 和 信息 类 型 的 格式 化 方法 感到 满意 ,只 是 
想 更 改 信息 的 目的 地 ,那么 实现 DoLogString 函 数 就 足够 了 ,而 重 载 DoLogH Any HIRAI LAE 
意 的 定制 输出 信息 的 格式 ,不 过 同时 你 也 需要 自己 区 分 信息 的 各 种 类 型 .你 可 以 参考 
src/common/log.cpp 文 件 看 看 wxWidgets 是 怎么 作 到 这 一 点 的 . 


wxWidgets 自 己 实现 了 几 个 wxLog 的 派生 类 ,你 也 可 以 读 一 读 它 们 的 代码 ,这 对 你 创建 自 定义 的 
log 目 标 也 是 有 好 处 的 .这 些 预 定义 的 log 目 标 包括 : 


wxLogStderr 料 所 有 的 信息 输出 到 FILE 作 为 参数 的 文件 中 ,如 果 FILE 为 空 , 则 输出 到 标准 错误 输 
出 . 

wxLogStream 和 wxLogStderr 功 能 相同 ,不 过 它 使 用 标准 C++ 的 ostream 类 和 cerr 流 来 代 蔡 FILE* 
和 stderr. 

wxLogGui 则 是 wxWidgets 所 有 wxWidgets 程 序 默 认 使 用 的 log 目 标 , 依 平台 的 不 同 它 实 现 了 不 同 
的 输出 处 理 . 

wxLogWindow 则 提供 了 一 个 类 似 " 跟 踪 终 端 " 之 类 的 窗口 ,这 个 窗口 将 显示 所 有 的 输出 信息 ,同时 
这 些 信 息 也 将 显示 在 之 前 的 log 目 标 上 .这 个 跟踪 终端 窗口 提供 了 清除 信息 ,关闭 窗口 以 及 将 所 有 
信息 保存 到 文件 中 的 功能 


wxLogNull 则 被 用 来 临时 阻止 某 些 错误 信息 的 输出 ,比如 你 打开 不 存在 的 文件 的 时 候 将 显示 一 个 
某 误 信息 ,有 时 候 你 不 希望 显示 这 个 信息 ,可 以 在 栈 上 创建 一 个 wxLogNull 变 量 , 在 这 个 变量 的 作 
用 域 范围 内 ,没有 任何 错误 信息 将 被 显示 ,而 离开 了 其 作用 域 , 则 所 有 的 信息 又 可 以 正常 显示 了 . 


wxFile file; 
// WxFile.0pen( ) 在 打开 一 个 不 存在 的 文件 时 通常 会 显示 错误 信息 , 但 是 在 这 里 我 们 不 想 看 到 这 个 信息 ， 
{ 

wxLogNull logNo; 

if ( !file.Open("bar") ) 

... process error ourselves ... 

} // wxLogNul LANA ANARA, 旧 的 1og 目 标 被 恢复 . 
wxLogMessage("..."); // 可 以 被 显示 


有 时 候 你 也 许 希望 将 信息 输出 到 多 个 地 方 ,比如 ,你 可 以 希望 所 有 的 信息 在 正常 显示 的 同时 被 保 
存在 某 个 文件 中 ,这 时 候 你 可 以 使 用 wxLogChain 和 wxLogPassThrough, 如 下 所 示 : 





// 这 将 隐 式 的 设置 当前 10g 目 标 

wxLogChain *logChain = new wxLogChain(new wxLogStderr); 

// 所 有 的 输出 将 被 同时 显示 在 stderr 和 通常 的 地 方 

// 不 要 直接 删除 1o0gChain 指 针 , 这 会 导致 当前 活动 log 目 标 为 一 个 不 确定 的 指针 . 
// 应 该 使 用 SetActiveTarget. 

delete wxLog: :SetActiveTarget(new wxLogGui); 


wxMessageOutput VS wxLog 


有 时 候 , 使 用 wxLog 不 太 合适 ,这 主要 是 因为 wxLog 对 输出 的 信息 作 了 过 多 的 义理 ,并 且 会 等 待 空 
闲 的 时 候 才 会 显示 这 些 信息 .而 wxMessageOutput 和 它 的 派生 类 则 可 以 作为 你 的 底层 printf 的 
替代 品 ,来 在 GUI 和 命 命 行程 序 中 使 用 .你 可 以 象 使 用 printf 范 数 那样 使 用 
wxMessageOutput::Printf 范 数 ,比如 ,如 果 你 想 把 信息 打印 在 标准 错误 输入 : 


#include "wx/msgout.h" 
wxMessageOutputStderr err; 
err.Printf(wxT("Error in app %s.\n"), appName.c_str()); 


wxMessageOutputDebug 将 信息 显示 在 调试 器 终端 或 者 是 标准 错误 输出 中 ,这 主要 看 程序 是 以 
什么 方式 运行 的 ,和 wxLogDebug 不 同 ,wxMessageOutputDebug 输 出 的 信息 在 正式 版 本 中 将 不 
会 被 移 除 .GUI 应 用 程序 还 可 以 使 用 wxMessageOutputMessageBox 来 即时 显示 消息 ,而 不 比 象 
wxLog 那 样 需要 搜集 (其 它 Log 信 息 ) 和 等 待 (系统 空闲 ), 同 样 的 还 存在 一 个 

wxMessageOutputLog 类 , 它 将 消息 输出 到 wxLogMessage. 


和 wxLog 类 似 ,wxMessageOutput 也 有 一 个 当前 的 目标 ,这 个 目标 可 以 通过 
wxMessageOutput'::Set 设 置 ,通过 wxMessageOutput::Get 获 取 . 默 认 的 目标 是 系统 初始 化 的 时 
候 由 wxWidgets 设 置 的 ,在 命令 行程 序 中 使 用 的 是 wxMessageOutputStderr, 在 GUI 程序 中 使 用 
的 是 wxMessageOutputMessageBox.wxWidgets 内 部 经 常 使 用 这 个 对 象 ,比如 在 
wxCmdLineParser 类 中 ,使 用 了 下 面 的 代码 : 


wxMessageOutput* msgOut = wxMessageOutput: :Get(); 
if ( msgOut ) 


wxString usage = GetUsageString(); 
msgOut->Printf( wxT("%s%s"), usage.c_str(), errorMsg.c_str() ); 


} 


else 


wxFAIL_MSG( _T("no wxMessageOutput object?") ); 


提供 运行 期 类 型 信息 


和 大 多 数 编程 框架 一 样 ,WxWidgets 提 供 了 上 比 标准 C++ 更 多 的 运行 期 类 型 信息 .这 对 于 在 运行 期 

依 对 象 类 型 决定 行为 ,或 者 在 上 节 提 到 的 错误 报告 中 都 是 很 有 用 处 的 .并 且 它 还 允许 你 通过 对 象 
名 来 创建 一 个 那 种 类 型 的 变量 .需要 注意 的 是 :只 有 派生 自 wxObject 的 类 才 可 以 使 用 wxWidgets 
的 RTTI (运行 期 类 型 信息 ). 


如 果 你 不 需要 动态 创建 功能 ,你 需要 在 类 声明 中 使 用 DECLARECLASS(class) 宏 ,而 在 类 实现 中 
使 用 IMPLEMENT_CLASS(class, baseClass) 宏 ,反之 , 则 需要 使 用 
DECLARE_DYNAMIC_CLASS(class) 2 #IMPLEMENT_ DYNAMIC CLASS(class, 
baseClass)%. 4%, RIRA EEA ab A 6 EAE ke RE RK A TRU A E 
数 ,否则 在 编译 那些 用 来 动态 产生 某 个 对 象 的 代码 时 , 编译 器 可 能 会 报错 . 


下 面 是 定义 和 动态 创建 一 个 对 象 的 例子 : 


class MyRecord: public wxObject 


{ 
DECLARE_DYNAMIC_CLASS(MyRecord) 
public: 
MyRecord() {} 
MyRecord(const wxString& name) { m_name = name; } 
void SetName(const wxString& name) { m_name = name; } 
const wxString& GetName() const { return m_name; } 
private: 
wxString m_name; 


J; 
IMPLEMENT_DYNAMIC_CLASS(MyRecord, wxObject) 
MyRecord* CreateMyRecord(const wxString& name) 


MyRecord* rec = wxDynamicCast (wxCreateDynamicObject(wxT("MyRecord")), MyRecord); 
if (rec) 

rec->SetName(name) ; 
return rec; 


当 CreateMyRecord 被 调用 的 时 候 ,wxCreateDynamicObject 负 责 创 建 所 需 的 对 象 ,而 
wxDynamicCast 则 负责 进行 类 型 检查 ,如 果 检 查 失败 则 返回 NULL. 也 许 你 觉得 这 个 代码 看 上 去 
并 没有 什么 实际 的 用 处 ,但 是 在 从 文件 加 载 一 堆 不 同类 型 的 对 象 的 时 候 , 这 是 非常 有 用 的 .对 象 的 
数据 和 它 的 名 称 被 一 起 存放 在 文件 中 ,通过 名 字 创 建 一 个 对 象 的 实例 ,然后 再 使 用 这 个 实例 加 载 
相应 的 数据 . 


下 面 我 们 来 介绍 以 下 运行 期 类 型 信息 的 一 起 其 它 相 关 宏 : 


CLASSINFO(class) 返 回 一 个 指向 wxClasslnfo 类 型 的 指针 .你 可 以 使 用 wxObject:IsKindOf 函 数 
来 判断 某 个 对 象 是 否 是 对 应 的 类 型 : 


if (obj->IsKindof (CLASSINFO(MyRecord))) 


} 


使 用 DECLARE_ABSTRACT_CLASS(class) 和 IMPLEMENT_ABSTRACT_CLASS(class， 
baseClass) 来 定义 虚 类 . 


使 用 DECLARE_CLASS2(class) 和 IMPLEMENT_CLASS2(class, baseClass1, baseClass2) 来 
定义 有 两 个 父 类 的 类 . 

使 用 DECLARE_APP(class) 和 IMPLEMENT_APP(class) 来 使 得 wxWidgets 知 道 整个 应 用 程序 

类 的 运行 期 类 型 信息 . 

wxConstCast(ptr, class) 用 来 代替 const_cast<class *>(ptr), 如 果 编 译 器 不 支持 const_cast, 则 使 
用 旧 的 C 语 言 的 类 型 强制 转换 . 


wxDynamicCastThis(class) 相 当 于 wxDynamicCast(this, class), 但 是 后 者 在 某 些 编译 器 上 会 导 
致 永 真 比较 告警 ,因为 它 将 测试 是 否 指针 为 空 ,而 this 指 针 永 远 不 可 能 为 空 ,前 者 可 以 避免 这 个 告 


wxStaticCast(ptr, class) 在 调试 模式 将 检查 强制 类 型 转换 的 有 效 性 (如 果 wxDynamicCast(ptr, 
class) == NULL 将 引发 断言 错误 ) 然 后 返回 static_cast<class*>(ptr) 的 等 同 结果 . 


wx_const_cast(T, x) 在 编译 器 支持 的 情况 下 等 同 于 const_cast<T>(x), 否 则 等 同 于 (T)x(C 语 言 类 
型 强制 转换 语法 ). 和 wxConstCast 不 同 的 是 , 它 强制 转换 的 是 T 本 身 而 不 是 指向 T 的 指针 ,而 且 参 
数 的 顺序 也 和 标准 强制 转换 的 顺序 相同 . 


wx_reinterpret_cast(T, x) 则 相当 于 reinterpret_cast<T>(x), 如 果 编 译 器 不 支持 则 等 同 于 (T)x. 


wx_static_cast(T, x) 等 同 于 static_cast<T>(x), 如 果 编 译 器 不 支持 则 等 同 于 (T)x. 和 wxStaticCast 
不 同 的 是 , 它 不 做 类 型 检查 ,并 且 采 用 和 标准 的 静态 转换 相同 的 参数 顺序 ,而 且 转 换 的 也 是 T 而 不 
是 指向 T 的 指针 . 


15.6 使 用 wxModule 


wxWidgets 的 模块 管理 系统 是 一 个 很 简单 的 系统 , 它 允 许 应 用 程序 (以 及 wxWidgets 自 己 ) 可 以 定 
义 将 被 wxWidgets 自 动 在 开始 和 退出 时 执行 的 初始 化 和 资源 清理 代码 .这 有 助 于 避免 应用 程序 
在 Onlnit 本 数 和 OnExit 函 数 中 依 它们 功能 的 需要 添加 过 多 的 代码 . 


要 定义 一 个 这 样 的 模块 ,你 需要 实现 一 个 wxModule 的 派生 类 , 重 载 其 Onlnit 和 OnExit 郴 数 ,然后 
在 其 声明 部 分 使 用 DECLARE_DYNAMIC_CLASS 宏 ,在 其 实现 部 分 使 用 
IMPLEMENT_DYNAMIC_CLASS 宏 (它们 可 以 位 于 同一 个 文件 内 ). 在 系统 初始 化 的 时 

候 ,wxWidgets 会 找到 所 有 wxModule 的 派生 类 ,创建 一 个 它 的 实例 然后 执行 其 Onlnit 函 数 ,而 在 系 
统 退出 时 执行 其 OnExit 郴 数 . 


举例 如 下 : 


// 下 面 这 个 模块 用 来 自动 进行 DDE 的 初始 化 和 清除 动作 , 
class wxDDEModule: public wxModule 


{ 

DECLARE_DYNAMIC_CLASS(wxDDEModule ) 

public: 
wxDDEModule() {} 
bool OnInit() { wxDDEInitialize(); return true; }; 
void OnExit() { wxDDECleanUp(); }; 


}; 
IMPLEMENT_DYNAMIC_CLASS(wxDDEModule, wxModule) 


15.7 加 载 动态 链接 库 


如 果 你 想 要 使 用 位 于 动态 链接 库 中 的 函数 ,你 需要 使 用 wxDynamicLibrary 类 .使 用 方法 是 :在 其 
构造 琐 数 或 者 Load 回 数 中 传递 动态 链接 库 的 文件 名 ,如 果 你 不 希望 wxWidgets 自 动 增加 类 

似 .dll(windows) 或 者 .sol(linux) 这 样 的 扩展 名 ,还 需要 传递 WxDL_VERBATIM 参 数 .如 果 加 载 成 
功 ,就 可 以 使 用 GetSymbol 函 数 通 过 画 数 名 使 用 其 中 的 函数 了 .下 面 的 例子 演示 了 怎样 加 载 和 使 
用 windows 的 标准 控件 动态 链接 库 : 


#include "wx/dynlib.h" 
INITCOMMONCONTROLSEX icex; 
icex.dwSize = sizeof(icex); 
icex.dwICC = ICC_DATE_CLASSES; 
// 加 载 comct132 .d11 
wxDynamicLibrary d1l1ComCt132(wxT("comct132.d11"), wxDL_VERBATIM); 
// 定义 ICCEx_t 类 型 
typedef BOOL (WINAPI *ICCEx_t)(INITCOMMONCONTROLSEX *); 
// $FInitCommonControlsEx#sR 
ICCEx_t pfnInitCommonControlsEx = 
(ICCEx_t) dllComCtr132.GetSymbol(wxT("InitCommonControlsEx")); 
// ARRAN. 
if ( pfnInitCommonControlsEx ) 


(*pfnInitCommonControlsEx) (&icex) ; 


wxDYNLIB_FUNCTION 宏 使 得 上 面 代 码 中 的 GetSymbol 行 更 为 简洁 : 


wxDYNLIB_FUNCTION( ICCEx_t, InitCommonControlsEx, dllComCt132 ); 


wxDYNLIB_FUNCTION 使 得 你 只 需要 使 用 一 次 返回 值 类 型 作为 其 第 一 个 参数 , 它 将 创建 一 个 对 
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如 果 动 态 链接 库 被 成 功 加 载 , 它 闻 在 对 点 的 wxDynamicLibrary 对 象 被 释放 的 时 候 , 在 其 析 构 函数 
中 自动 被 卸载 ,如 果 你 希望 在 wxDynamicLibrary 被 释放 以 后 继续 使 用 相 点 的 函数 ,你 应 该 调用 
首先 调用 wxDynamicLibrary 的 Detach 函 数 . 


15.8 Fine 


wxWidget 创 立 的 时 间 比 起 "异常 "的 概念 引入 C++ 要 早 的 多 ,因此 在 其 代码 中 已 经 花费 了 大 量 的 
力气 来 应 付 各 种 各 样 的 异常 ,因此 ,可 以 说 ,整个 wxWidgets 框 架 内 部 都 没有 使 用 C++ 的 异常 机 
制 .当然 ,这 并 不 意味 着 你 不 可 以 在 你 的 代码 中 使 用 C++ 的 异常 机 制 ,相反 ,你 在 你 的 代码 中 使 用 
它 是 安全 的 ,而 且 wxWidgets 也 会 帮助 你 这 样 作 . 


要 在 你 的 程序 中 使 用 异常 处 理 机 制 ,最 简单 的 方法 就 是 根本 忽略 它 的 存在 ,既然 wxWidgets 不 会 
抛 出 任何 异常 ,你 又 何必 去 处 理 异 常 呢 ? 除 非 你 的 代码 自己 抛 出 了 一 些 异常 .这 是 最 简单 的 方法 ， 
但 是 有 时 候 , 对 于 处 理 各 种 可 能 遇 到 的 错误 来 说 ,这 种 方法 是 不 够 的 . 


另外 一 个 策略 是 你 只 用 异常 机 制 来 处 理 那 些 非常 致命 的 系统 错误 .这 种 情况 下 ,你 不 寄 希 望 于 你 
nae ici 错误 中 恢复 , 它 所 作 的 事情 只 是 让 你 的 程序 以 一 种 更 绅士 的 方式 结束 .这 
种 情况 下 ,你 只 需要 重 载 你 的 wxApp 派 生 类 的 OnUnhandledException 画 数 来 执行 资源 清除 工 

作 , 注 意 这 时 候 所 有 和 异常 有 关 的 信息 已 经 被 清除 了 .如 果 你 需要 这 些 信 息 ,你 需要 在 OnRun 画 

数 中 针对 调用 基 类 画 数 的 语句 使 用 try/catch 语 句 块 . 这 将 使 得 你 可 以 捕获 在 应 用 程序 主 循环 中 
引发 的 异常 .如 果 你 还 希望 处 理 在 应 用 程序 初始 化 和 退出 时 候 引 发 的 异常 ,你 需要 在 你 的 Oninit 
和 OnExit 函 数 中 使 用 try/catch 语 句 . 


最 后 ,如 果 你 希望 在 异常 发 生 的 时 候 , 你 的 点 用 程序 可 以 从 异常 中 恢复 并 且 继 续 运 行 ,那么 :如 果 
你 程序 的 异常 主要 集中 在 某 个 类 (或 其 派生 类 ) 的 事件 处 理 函 数 中 ,你 可 以 你 可 以 在 这 个 类 的 
ProcessEvent 辑 数 中 统一 处 理 这 些 异常 ,如 果 这 是 不 切实 际 的 ,你 还 可 以 考虑 重 载 WxApp:: 
HandleEvent 函 数 , 它 将 允许 你 拦截 并 义理 任何 由 事件 义理 函数 引发 的 异常 . 


wxWidgets 的 异常 处 理 机 制 默认 是 打开 的 , 它 取 决 于 wxUSE_EXCEPTIONS 标 记 被 设置 为 1. 但 
是 如 果 它 被 设置 为 0, 在 windows 版 本 中 ,你 需要 修改 include/wx/msw/setup.h 将 其 更 改 为 1, 或 者 
在 别 的 平台 上 运行 configure 时 增加 -- enable-exceptions 开 关 . 而 将 其 设置 为 0 或 者 使 用 -- 
disable-exceptions 开 关 将 会 产生 更 为 小 巧 和 相对 快速 的 wxWidgets 库 .另外 ,在 windows 平 台 
下 ,如 果 你 使 用 的 是 Visual C++, 你 希望 使 用 wxApp::OnFatalException 画 数 来 处 理 异 常 而 不 是 引 
发 一 个 GPF( 一 般 保护 性 错误 ), 你 可 以 在 你 的 setup.h 中 将 wxUSE_ON_FATAL_EXCEPTION 设 
置 为 1. 相 反 的 ,如 果 你 宁愿 将 这 种 错误 扔 给 你 的 调试 器 ,将 它 设置 成 0. 


wxWidgets 自 带 一 个 使 用 异常 的 例子 ,位 于 samples/except 目 录 中 . 


15.9 调试 提示 


自我 保护 的 程序 ,错误 报告 何其 它 的 编码 技术 只 能 帮助 你 这 么 多 了 ,要 单 步 跟踪 你 的 代码 ,检查 每 
个 变量 的 值 ,准确 的 告诉 你 你 的 程序 有 什么 异常 行为 或 者 从 代码 的 什么 地 方 退出 ,你 还 需要 使 用 
一 个 调试 工具 .因此 ,针对 你 的 代码 ,你 至 少 需要 维护 两 套 配 置 文件 ,一 套 调 试 版 本 何 一 套 正式 版 

本 .调试 版 本 将 包含 更 多 的 错误 检测 ,将 关闭 编译 器 的 优化 开关 并 且 将 包含 调试 程序 需要 的 文件 
名 , 行 号 等 调试 信息 .在 调试 模式 , 宏 WXDEBUG 总 是 被 定义 了 ,因此 你 可 以 使 用 这 个 宏 来 编写 那 

些 仅 存在 于 调试 版 本 中 的 代码 ,不 过 类 似 wxLogDebug 这 样 的 函数 ,即使 你 没有 使 用 WXDEBUG 
宏 将 其 包含 , 它 仍然 将 在 正式 版 本 中 被 移 除 . 


确实 有 很 多 人 从 来 没有 使 用 过 调试 器 ,但 是 在 你 熟悉 了 这 些 工具 以 后 , 它 将 大 大 降低 你 的 工作 量 . 
在 windows 平 台 上 ,VC 自 带 了 一 个 很 不 错 的 调试 器 .如 果 你 使 用 的 是 GCC, 你 可 以 使 用 GDB 工 具 
包 , 它 工作 在 命令 行 模式 下 ,你 也 可 以 使 用 一 些 集成 了 GDB 的 IDE 环 境 . 更 多 的 信息 可 以 参考 附录 
E,"wxWidgets 的 第 三 方 工具 ". 


wxWidgets 支 持 同 时 编译 多 个 版 本 .在 windows 平 台 上 ,你 可 以 给 对 应 的 Makefile 传 递 
BUILD=debug 或 BUILD=release 这 样 的 开关 .如 果 你 使 用 的 是 configure 程 序 , 你 可 以 配置 不 同 
的 版 本 编译 在 不 同 的 目录 ,然后 在 各 个 版 本 中 使 用 类 似 -- enable-debug 或 --disable-debug 这 样 
不 同 的 开关 . 某 些 集成 开发 环境 出 于 各 种 各 样 的 原因 不 允许 你 的 应 用 程序 同时 使 用 不 同 的 配置 
文件 ,对 于 这 样 的 集成 开发 环境 ,作者 的 忠告 是 :不 要 使 用 它们 . 


调试 X11 错误 


极 少 的 情形 下 ,wxGTK 程 序 会 由 于 X11 的 错误 而 崩溃 ,这 时 候 你 的 应 用 程序 将 立即 退出 而 不 给 你 
任何 栈 调 用 情况 的 打印 ,这 种 问题 是 非常 难以 跟踪 的 ,在 这 种 情况 下 ,你 需要 象 下 面 代 码 展 示 的 那 
样 ,增加 一 个 错误 义理 函数 : 


#if defined(__WXGTK_) 

#include &1t;X11/X1lib.h&gt; 

typedef int (*XErrorHandlerFunc)(Display *, XErrorEvent *); 
XErrorHandlerFunc gs_pfnxXErrorHandler = 0; 

int wxXErrorHandler (Display *display, XErrorEvent *error) 


if (error->error_code) 


{ 
char buf[64]; 
XGetErrorText (display, error->error_code, buf, 63); 
printf ("** X11 error in wxWidgets for GTK+: %s\n serial %ld error_code %d 
request_code %d minor_code %d\n", 
buf, 
error->serial, 
error->error_code, 
error->request_code, 
error->minor_code); 


} 

// 去 掉 下 面 的 注释 以 便 将 错误 重 定向 道 你 的 处 理 函 数 . 
#if 0 

if (gs_pfnxXErrorHandler ) 

return gs_pfnXErrorHandler(display, error); 

#endif 

return 0; 
} 


#endif 
// __WXGTK__ 
bool MyApp: :OnInit(void) 
{ 
#if defined(__WXGTK_) 
// BRR RBA 
gs_pfnxXErrorHandler = XSetErrorHandler( wxxXErrorHandler ); 
#endif 


return true; 


现在 ,你 的 应 用 程序 在 遇 到 这 样 的 错误 的 时 候 ,将 会 产生 一 个 普通 的 段 错 误 .如 果 你 在 启动 你 的 应 
用 程序 的 时 候 传递 了 --sync 参 数 ,这 个 段 错误 将 正好 显示 在 被 传递 了 错误 参数 的 X11 男 数 的 地 
方 . 


一 个 简单 有 效 的 定位 问题 方法 


如 果 你 确实 碰 到 了 一 个 很 难 定位 的 问题 ,一 个 好 的 方法 是 使 用 尽量 少 的 代码 来 重 现 这 个 问题 ,你 
可 以 修改 wxWidgets 自 带 的 任何 一 个 例子 ,增加 一 些 代码 来 重 现 你 的 问题 ,或 者 把 你 的 代码 制作 
一 份 拷贝 , 逐 段 的 去 掉 那 些 不 影响 这 个 错误 的 代码 ,直至 你 可 以 准确 的 定位 出 是 那些 代码 导致 了 
这 个 错误 的 产生 .如 果 你 认为 这 是 wxWidgets 本 身 的 错误 ,把 你 修改 后 的 导致 问题 出 现 的 
wxWidgets 例 子 发 送 给 wxWidgets 社 区 ,相信 这 个 问题 将 被 很 快 修正 


调试 一 个 发 布 版 本 


某 些 情况 下 ,你 的 应 用 程序 可 能 在 调试 版 本 工作 正常 ,而 在 正式 版 本 中 则 工作 不 正常 ,这 可 能 是 由 
于 编译 器 使 用 的 不 同 运 行 期 库 文件 的 细微 差别 导致 的 .如 果 你 正在 使 用 的 是 VC, 你 可 以 创建 一 
个 和 调试 版 本 一 模 一 样 的 配置 ,但 是 却 定义 了 NDEBUG 宏 ,这 将 使 得 你 的 代码 和 wxWidgets 和 调 
试 信息 都 具备 ,运行 的 时 候 却 使 用 的 是 发 布 版 本 的 运行 库 . 这 至 少 可 以 让 你 确定 是 不 是 由 于 运行 
期 库 的 原因 导致 了 这 个 问题 . 


通常 当 你 发 布 你 的 应 用 程序 的 时 候 都 将 使 用 去 除了 所 有 调试 信息 的 版 本 ,但 是 有 时 候 你 的 客户 
会 遇 到 一 些 在 你 的 机 器 上 很 难 重 现 的 问题 ,这 时 候 你 可 能 想 给 你 的 用 户 发 送 一 份 调试 版 本 的 程 
序 ( 在 windows 平 台 上 ,通常 你 需要 使 用 静态 编译 的 方法 以 避免 同时 发 送 那些 调试 模式 的 动态 链 


的 程序 ,在 程序 异常 退出 的 时 候 , 将 会 产生 一 个 文件 记录 当时 的 情况 .参考 你 的 编译 器 的 信息 以 及 
网 上 的 教程 来 了 解 怎 样 使 用 由 DrWatson 产 生 的 这 个 文件 来 定位 你 的 代码 中 的 异常 . 


如 果 你 使 用 的 是 MinGW, 你 可 以 使 用 一 个 叫做 DrMinGW 的 工具 来 在 程序 异常 退出 时 候 打印 出 


从 http://www.mingw.org 下 载 这 个 工具 ,如 果 你 的 客户 有 耐心 并 且 很 合作 ,你 可 以 把 这 个 工具 发 
送 给 他 们 然后 让 他 们 把 产生 的 报告 发 送 给 你 . 


在 Unix 平 台 上 ,调试 版 本 的 可 执行 文件 可 以 产生 一 个 core 文 件 (这 依赖 于 系统 的 设置 ,参考 Unix 命 
今 ulimit 的 man 手 册 ). 你 可 以 象 你 平时 调试 可 执行 文件 那样 使 用 这 个 core 文 件 ,以 便 观 察 程序 退 
出 时 候 的 现场 情况 .然后 ,这 个 core 文 件 可 能 会 很 大 ,你 的 客户 可 能 不 大 愿意 发 送 给 你 这 样 的 一 个 
core dump 文 件 . 


另外 的 一 个 蔡 代 方案 是 ,你 可 以 在 你 的 程序 中 自己 记录 程序 的 重要 的 执行 情况 .这 方面 你 可 以 参 
考 wxWidgets 手 册 中 wxDebugReport 类 相关 的 内 容 ,这 个 类 可 以 产生 一 个 合适 email 给 程序 开 
发 商 的 报告 .类 似 的 ,你 还 可 以 使 用 来 自 http: /wxcode.sf.net 的 wxCrashPrint(for linux) 或 者 来 自 
http://www.codeproject.com/tools/blackbox.asp 的 BlackBox(for windows). 


第 十 五 章 小 结 


在 这 一 章 里 ,我 们 讨论 了 内 存 管理 和 错误 检测 各 个 方面 的 内 容 . 你 现在 应 该 了 解 到 ,什么 时 候 使 用 
new 来 创建 对 象 ,什么 时 候 直接 使 用 栈 变 量 ,你 的 应 用 程序 应 该 怎样 进行 资源 清除 工作 ,怎么 识别 
内 存 泄漏 ,怎么 使 用 宏 来 创建 有 自我 保护 意识 的 程序 .你 也 看 到 了 怎样 动态 创建 对 象 ,也 知道 了 何 
时 使 用 wxLogDebug 何 时 使 用 wxLogError. 也 看 到 了 怎样 在 wxWidgets 中 使 用 C++ 异常 机 制 ,我 

们 还 对 怎样 调试 应 用 程序 给 出 了 一 些 提示 . 接 下 来 我 们 来 看 看 怎样 让 你 的 应 用 程序 支持 多 种 语 


Di 


第 十 六 章 编写 国际 化 程序 


如 果 你 象 要 求 你 的 程序 支持 多 平台 一 样 要 求 你 的 程序 支持 多 语言 ,那么 你 的 程序 可 能 会 有 更 多 
的 用 户 , 这 将 很 大 程度 的 提高 你 的 程序 成 功 的 机 会 .本 章 我 们 就 来 谈 一 谈 怎样 实现 这 样 的 目标 ,要 
让 你 的 应 用 程序 成 为 国际 化 的 程序 ,你 需要 用 到 的 知识 ,也 就 是 俗称 的 "i18n"( 没 错 ,i18n). 


16.1 国际 化 介绍 


当 把 你 的 程序 带 到 国际 化 舞 态 上 时 ,想到 的 第 一 件 事情 就 是 翻译 .你 需要 为 你 的 应 用 程序 中 的 每 
一 个 字符 串 针对 每 一 种 可 能 用 到 的 语言 准 各 一 个 翻译 字符 串 . 在 wxWidgets 中 ,这 是 通过 使 用 
wxLocale 类 来 加 载 某 个 分 类 条 目 来 实现 的 .这 种 技术 也 许 和 你 以 前 用 过 的 字符 串 表 的 方式 不 太 
一 样 ,字符 串 表 的 方式 是 给 程序 中 的 每 个 字符 串 一 个 标识 符 ,然后 通过 切换 不 同 的 字符 串 表 来 实 
现 翻 译 的 .而 分 类 条 目 则 是 通过 把 字符 串 按 照 某 一 种 分 类 进行 翻译 的 作法 (你 当然 可 以 使 用 你 的 
本 地 系统 支持 的 任何 方法 ,不 过 要 注意 ,在 wxWidgets 库 内 部 ,也 使 用 的 是 分 类 条 目的 方法 ). 


如 果 没 有 指定 分 类 条 目 , 源 代码 中 的 字符 串 将 被 显示 在 用 户 界 面 的 菜单 或 者 按钮 等 控件 上 .如 果 
你 的 本 地 语言 包含 非 ASCIl 字 符 , 你 就 必须 进行 翻译 (使 用 一 个 分 类 条 目 ), 因 为 源 代 码 只 支持 
ASCII 码 . 


代表 另外 一 种 语言 的 文本 可 以 采用 各 种 各 样 的 编码 方式 ,这 意味 着 同一 个 字 节 在 不 同 的 语言 中 
可 能 代表 不 同 的 字符 .你 需要 确定 你 的 应 用 程序 能 够 正确 识别 这 些 编 码 并 且 你 的 GUI 控件 可 以 
正确 显示 这 些 编码 .也 就 是 说 ,你 需要 注意 各 种 情况 下 使 用 的 编码 方式 以 及 不 同 编码 方式 之 间 的 
互相 转换 的 问题 . 


国际 化 的 另外 一 个 方面 是 格式 化 数字 ,日 期 和 时 间 . 注 意 即使 是 在 同一 种 语言 中 ,它们 也 有 可 能 不 
同 .比如 英语 中 的 数字 1,234.56 在 德语 中 被 写作 1.234,56, 而 在 瑞士 德语 中 则 被 写作 1234.56. 在 
美国 11 月 10 日 的 表示 方法 是 11/10, 而 同样 的 写法 在 UK 则 代表 10 月 11 日 .我 们 很 快 会 介绍 
wxWidgets 如 何 义理 这 些 复 杂 的 情况 . 


翻译 的 字符 串 有 时 候 会 比 代码 中 的 英文 字符 串 要 长 ,这 意味 着 窗口 控件 的 布局 需要 调整 为 不 同 
的 大 小 .在 第 7 章 (使 用 布局 控件 进行 布局 ) 中 介绍 的 布局 控件 可 以 解决 这 个 问题 .另外 一 个 关于 布 
局 的 问题 是 ,英语 是 从 左 向 右 阅读 的 ,而 某 些 语 言 ,比如 阿拉 伯 语 和 和 希 伯 来 语 是 从 右 到 左 的 顺序 读 
的 ( 称 为 RTL), 目 前 wxWidgets 中 对 于 这 个 问题 还 没有 一 个 很 好 的 解决 机 制 . 


最 后 一 个 需要 根据 不 同 的 语言 进行 调整 的 项 目 是 你 用 到 的 图 片 和 声音 .比如 说 ,你 正在 制作 一 个 
电话 目录 程序 , 它 有 一 个 特性 是 可 以 读 出 来 电话 号 码 ,这 个 读音 是 语言 有 关 的 ,另外 你 也 可 能 需 
根据 国家 的 不 同 使 用 不 同 的 图 片 . 


16.2 从 翻译 说 起 


wxWidgets 是 通过 wxLocale 来 提供 语言 翻译 支持 的 .而 且 它 自己 也 已 经 被 完整 的 支持 了 很 多 种 
语言 .请 从 wxWidgets 的 官方 网 站 下 载 最 新 的 翻译 包 . 


wxWidgets 提 供 的 国际 化 语言 支持 和 GNU 的 gettext 工 具 包 非常 的 相似 .wxWidgets 使 用 的 分 类 
条 目 机 制 和 gettext 的 分 类 条 目 机 制 是 二 进 制 兼容 的 ,意味 着 你 可 以 使 用 所 有 的 gettext 工 具 . 并 且 
在 运行 时 不 需要 别 的 任何 附加 的 库 支持 因为 wxWidgets 内 部 实现 了 对 条 目 文 件 的 读 取 . 


在 程序 开发 过 程 中 ,你 需要 gettext 工 具 包 来 操作 分 类 条 目 ( 或 者 poEdit 工 具 , 参 考 下 面 的 小 节 ). 有 
两 种 类 型 的 消息 分 类 条 目 文 件 ,一 种 是 源 文件 , 它 是 文本 格式 文件 ,扩展 名 为 .po, 另 外 一 种 是 二 进 
制 分 类 条 目 文 件 , 它 是 通过 分 类 条 目 源 文件 使 用 gettext 工 具 包 中 的 工具 msgfmt 创 建 的 ,扩展 名 

是 .mo. 在 程序 运行 过 程 中 只 需要 二 进 制 的 分 类 条 目 文 件 .针对 每 一 种 你 想 要 支持 的 语言 ,你 都 需 
要 单独 提供 种 分 类 条 目 文 件 . 


poEdit 


你 不 需要 使 用 gettext 提 供 的 命令 行 工具 来 维护 你 的 分 类 条 目 .Vaclav Slavik 制 作 了 一 个 叫做 
poEdit 的 工具 , 它 是 一 个 图 形 化 的 gettext 前 端 工具 ,可 以 从 http://www.poedit.org 下 载 .运行 界面 
如 下 图 所 示 . 它 可 以 用 来 帮助 你 维护 分 类 条 目 , 产 生 .mo 文 件 以 及 随 着 你 的 代码 的 更 改 和 增加 将 
新 的 需要 翻译 的 条 目 合 入 旧 的 分 类 条 目 文件 . 


©. pokdit ; C:\projectsMWritingTools\storylines\src\delstorylines. po 
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Original string Translation 
Style for action text. Stil für Aktionen 
Parenthetical Paranthese (Rahmen/Klammer) 
style for parentheticaltext. | StilfiirPararthesen | 
Transition In Szeneneinleitung 
Style for transitions in. Stil für Szeneneinletungen 
Transition Out Szenenende 
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Comment Kommentar 
Style for comments, within curly braces, Stil für Kommentare - in geschweiften Klammern 
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Style for parenthetical text 


Sti fiit Paranthesen 








1280 strings (6 fuzzy, 0 bad tokens, 0 not translated) 





一 步 一 步 介绍 创建 消息 翻译 分 类 条 目 
遵循 下 面 的 这 些 步骤 来 进行 某 个 消息 条 目的 建立 : 


1. 在 你 的 代码 中 ,将 需要 翻译 的 字符 串 常量 使 用 wxGettranslation 宏 或 者 它 的 简短 蔡 代 品 _() 
宏 括 起 来 .对 于 那些 不 需要 翻译 的 字符 串 , 也 请 使 用 wxT() 或 者 等 价 的 _T() 宏 括 起 来 ,以 便 其 


可 以 实现 Unicode 兼 容 . 

2. 将 你 在 代码 中 标识 为 需要 翻译 的 字符 串 整理 到 .po 文件 中 .当然 ,这 么 负责 的 步骤 你 不 需要 
使 用 手工 去 作 它 ,你 可 以 使 用 gettext 工 具 包 中 的 xgettext 工 具 , 然 后 使 用 "-k" 参 数 指定 到 底 翻 
译 wxGettranslation 宏 还 是 _() 宏 指 代 的 字符 串 . poEdit 工 具 也 可 以 帮 你 完成 这 个 工作 ,和 
xgettext 的 "-k" 参 数 等 价 的 功能 需要 在 配置 对 话 框 中 指定 . 

3. 将 整理 好 的 .po 文件 中 的 字符 串 翻 译 为 你 希望 使 用 的 那 种 语言 的 字符 串 , 每 种 语言 对 应 一 
个 .po 文件 ,并 且 要 指定 这 种 语言 使 用 的 编码 方式 . 


如 果 没 有 使 用 poEdit 工 具 ,你 可 以 使 用 任何 你 喜欢 的 文本 编辑 器 来 完成 这 个 工作 ,对 应 的 .po 
文件 的 文件 头 如 下 所 示 : 


# SOME DESCRIPTIVE TITLE. 

# Copyright (C) YEAR Free Software Foundation, Inc. 
# FIRST AUTHOR &1t;EMAIL@ADDRESS&gt;, YEAR. 

# 

msgid nn 

msgstr "" 

"Project-Id-Version: PACKAGE VERSION\n" 
"POT-Creation-Date: 1999-02-19 16:03+0100\n" 
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 
"Last-Translator: FULL NAME &l1t;EMAIL@ADDRESS&gt ; \n" 
"Language-Team: LANGUAGE &lt;LL@li.org&gt;\n" 
"MIME-Version: 1.0\n" 

"Content-Type: text/plain; charset=iso8859-1\n" 
"Content-Transfer-Encoding: 8bit\n" 


注意 倒数 第 二 行 的 charset 属 性 ,指定 了 这 个 分 类 条 目 文 件 使 用 的 编码 方式 .本 文件 中 所 有 的 
字符 串 都 将 采用 这 种 编码 方式 ,这 是 非常 重要 的 ,因为 如 果 你 使 用 了 非 Unicode 的 编码 而 没 
有 指定 其 编码 方式 ,那些 GUI 控件 将 不 知道 怎样 显示 你 翻译 的 文本 . 


4. 将 翻译 好 的 .po 文件 编译 为 二 进 制 的 .mo 文件 .这 要 用 到 一 个 工具 叫做 msgfmt,poEdit 也 可 以 
帮 你 完成 这 个 工作 . 使 用 msgfmt 的 命令 行 如 下 所 示 : 


msgfmt -o myapp.mo myapp.po 


5 在 你 的 代码 中 设置 合适 的 locale 参 数 以 便 它 使 用 对 应 的 分 类 条 目 ( 我 们 将 在 接 下 来 的 小 
节 ," 使 用 wxLocale" 中 介绍 相关 内 容 ). 


在 Mac OS X 系 统 上 ,你 还 需要 更 改 一 个 叫做 Info.plist 的 文件 ,这 个 文件 是 用 来 描述 你 的 软件 包 的 
相关 信息 的 . 它 是 一 个 使 用 UTF-8 编 码 的 Xml 文件 ,其 中 包含 一 个 叫做 
CFBundleDevelopmentRegion 的 条 目 用 来 描述 软件 的 开发 语言 (比如 说 :英语 ), 而 Mac OSX 将 
会 查询 软件 包 中 某 些 默认 路 径 来 找到 这 个 软件 支持 的 语言 .例如 ,如 果 存 在 目录 German.Iproj, 则 
认为 这 个 软件 支持 德语 .因为 wxWidgets 并 不 使 用 这 样 的 目录 名 称 ,你 需要 在 这 个 文件 中 显 式 的 
指定 你 的 应 用 程序 支持 的 语言 类 型 .这 可 以 通过 在 其 中 增加 CFBundleLocalizations 条 目 来 实 
现 ,如 下 所 示 : 


<key>CFBundleDevelopmentRegion</key> 
<string>English</string> 
<key>CFBundleLocalizations</key> 
<array> 
<string>en</string> 
<string>de</string> 
<string>fr</string> 
</array> 


使 用 wxLocale 


wxLocale 封 装 了 所 有 和 本 地 化 相关 的 设置 ,类 似 于 C 语 言 中 的 locale 的 概念 .通常 你 在 你 的 应 用 
程序 类 中 定义 一 个 wxLocale 类 型 的 成 员 ,比如 说 :m_locale, 然 后 在 你 的 应 用 程序 的 Onlnit 郴 数 
中 , 象 下 面 这 样 初始 化 这 个 变量 : 


if (m_locale.Init(wxLANGUAGE_DEFAULT, 
wxLOCALE_LOAD_DEFAULT | wxLOCALE_CONV_ENCODING) ) 


m_locale.AddCatalog(wxT("myapp")); 


注意 wxLocale::Init 画 数 将 会 查找 wxstd.mo 文 件 , 这 个 文件 代表 wxWidgets 自 己 的 翻译 分 类 条 目 . 
参数 wxLANGUAGE_DEFAULT 指 定 使 用 系统 默认 的 语言 ,你 也 可 以 通过 使 用 对 应 的 
WXLANGUAGE_xxx 宏 来 强制 指定 某 种 特定 的 语言 . 


当 wxLocale 加 载 一 个 翻译 条 目的 时 候 , 这 个 条 目 被 自动 从 它 自己 的 编码 转换 成 系统 当前 使 用 的 
编码 ,这 是 WXxLocale 的 默认 行为 ,如 果 你 不 希望 使 用 这 个 行为 ,你 可 以 在 调用 wxLocale::Init 时 不 
传递 WXLOCALE _CONV_ENCODING 标 记 . 


wxWidgets 在 哪些 目录 里 寻找 对 应 的 .mo 文件 呢 ? 对 于 任何 一 个 待 查 目 录 <DIR>, 它 的 查找 范围 
包括 下 面 的 这 些 目 录 : 
<DIR>/<LANG>/LC_MESSAGES 


<DIR>/<LANG> 
<DIR> 


到 底 哪 些 目录 是 待 查 目录 , 依 系统 的 不 同 各 不 相同 : 


。 在 所 有 的 平台 上 ,LC_PATH 环 境 变量 指定 的 目录 将 成 为 待 查 目录 . 

e 在 Unix 或 Mac OS X 上 ,wxWidgets 的 安装 路 径 郊 成 为 待 查 目录 ,另外 还 有 /share/locale， 
/usr/share/locale, /usr/lib/locale, /usr/locale /share/locale 以 及 当前 目录 . 

。 在 Windows 平 台 上 ,点 用 程序 所 在 的 目录 也 将 成 为 待 查 目录 . 


你 还 可 以 通过 辑 数 wxLocale::AddCatalogLookupPathPrefix 增 加 你 自己 的 待 查 目录 ,上 比如: 


wxString resDir = GetAppDir() + wxFILE_SEP_PATH + wxT("resources"); 
m_locale.AddCatalogLookupPathPrefix(resDir); 

// (i&resDirzc:\MyApp\resources, (Ri SAUER, 

// AddCatalog 将 查找 的 待 查 目录 除了 前 面 介绍 的 所 有 待 查 目录 外 ， 

// 还 将 额外 查找 下 面 的 路 径 : 








// c:\MyApp\resources\fr\LC_MESSAGES\myapp.mo 
// c:\MyApp\resources\fr\myapp.mo 

// c:\MyApp\resources\myapp.mo 
m_locale.AddCatalog(wxT("myapp")); 


通常 在 发 行 你 的 应 用 程序 的 时 候 ,你 应 该 为 每 个 语言 创建 一 个 子 目 录 , 目 录 名 称 使 用 代码 某 种 区 
域 的 标准 的 国际 化 名 称 , 然 后 在 其 中 放置 对 应 的 <appname>.mo. 比 如 ,wxWidgets 自 带 的 
internat 例 子 程序 将 |SO639 格 式 编码 的 法 语 和 德语 翻译 文件 分 别 放 置 在 fr 和 de 目录 中 . 


16.3 字符 编码 和 Unicode 


这 个 世界 上 有 太 多 太 多 的 字符 , 远 超过 了 一 个 字 节 (8bit) 可 能 容纳 的 256 个 数目 .为 了 显 式 超过 
256 个 字符 以 外 的 其 它 字符 ,一 个 新 的 手段 被 增加 进来 , 那 就 是 字符 编码 和 字符 集 (更 新 和 更 好 
的 "Unicode" 解 决 方案 ,我 们 也 将 很 快 谈 到 .). 

因此 ,到 底 字 节 161 代 表 什 么 字符 ,是 由 当前 使 用 的 字符 集 决 定 的 .在 ISO 8859-1(Latin-1) 字 符 集 
中 , 它 代表 的 是 一 个 倒 宇 的 感叹 号 ,而 在 ISO 8859-2 字 符 集中 , 则 代表 的 是 字母 a(Aogonek). 


当 你 在 一 个 窗口 上 绘制 字符 的 时 候 ,系统 必须 知道 你 使 用 的 编码 ,这 成 为 字体 编码 ,也 就 是 所 谓 的 
字符 集 .创建 一 个 没有 指定 字符 集 的 字体 意味 着 使 用 默认 编码 ,这 在 大 多 数 系统 上 都 是 没有 问题 
的 ,因为 大 多 数 人 都 在 使 用 支持 本 国语 言 的 系统 . 


但 是 ,如 果 你 确定 某 些 字符 使 用 的 是 不 同 的 编码 (比如 ISO 8859-2), 在 创建 字体 的 时 候 , 你 应 该 指 
定 这 种 编码 ,如 下 所 示 : 


wxFont myFont(10, wxFONTFAMILY_DEFAULT, wxNORMAL, wxNORMAL, 
false, wxT("Arial"), wxFONTENCODING_ISO08859_2); 


否则 ,在 一 个 西 文系 统 ISO 8859-1 中 ,字符 将 不 能 被 正确 显 式 . 


有 时 候 可 能 我 们 无 法 找到 一 个 合适 的 满足 某 种 编码 的 字体 ,这 种 情况 下 ,我 们 可 以 党 试 使 用 一 种 
代替 字体 ,不 过 你 需要 将 要 显 式 的 字体 转换 成 那 种 代替 字体 对 应 的 编码 方式 .下 面 的 代码 演示 了 
应 该 怎样 作 . 一 个 字符 串 text 的 编码 为 enc, 准 各 用 字体 facename 显 示 . 同 时 下 面 的 代码 也 演示 了 
wxCSConv 的 用 法 : 


// 我 们 有 一 段 'enc ' 编码 的 文本 , 我 们 希望 用 字体 
// 'facename ' Em. 
// 
// 首先 ,我们 必须 确定 这 个 字体 可 以 显示 这 种 编码 
wxString text; // 编码 方式 为 'enc' 
if (!wxFontMapper: :Get()->IsEncodingAvailable(enc, facename) ) 
{ 
// 不 能 支持 这 种 编码 , 需要 查找 替代 编码 ， 
// 能 支持 某 种 替代 编码 吗 ? 
wxFontEncoding alternative; 
if (wxFontMapper: :Get()->GetAltForEncoding(enc, &alternative, 
facename, false)) 
{ 


// 我 们 找到 了 蔡 代 编码 方案 'alternative '， 
// 因此 我 们 进行 编码 的 转换 , 转换 成 alternative. 
wxCSConv convFrom(wxFontMapper::GetEncodingName(enc)); 


wxCSConv convTo(wxFontMapper::GetEncodingName(alternative)); 


text = wxString(text.wc_str(convFrom), convTo) ; 
// 然后 创建 alternative 编 码 的 字体 
wxFont myFont(10, wxFONTFAMILY_DEFAULT, wxNORMAL, wxNORMAL, 
false, facename , alternative); 
dc.SetFont(myFont); 
} 
else 
{ 
// 不 能 找到 完美 替代 编码 ; 尝试 有 损耗 的 编码 方案 
// ISO 8859-1 (7-bit ASCII) 
wxFont myFont(10, wxFONTFAMILY_DEFAULT, wxNORMAL, wxNORMAL, 
false, facename, wxFONTENCODING IS08859_1); 
dc.SetFont(myFont); 


else 


// OK, 这 个 字体 可 以 支持 这 个 编码 . 
wxFont myFont(10, wxFONTFAMILY_DEFAULT, wxNORMAL, wxNORMAL, 
false, facename, enc); 
dc.SetFont(myFont); 


} 
// 最 后 , 我 们 使 用 选择 的 字体 绘制 可 能 已 经 经 过 编码 转换 的 字符 串 
dc.DrawText(text, 100, 100); 


转换 数据 


前 面 的 代码 演示 了 将 一 组 字 节 流 从 一 种 编码 转换 为 另外 一 种 编码 的 方法 .这 种 转换 可 以 有 两 种 
方法 ,第 一 种 是 使 用 wxEncodingConverter 类 ,这 种 方法 是 不 被 推荐 的 (可 能 在 后 续 版 本 种 被 淘 
汰 的 方法 ), 你 不 应 该 在 新 的 代码 种 使 用 这 种 方法 ,除非 你 的 编译 器 不 支持 wchar t 结 构 . 推荐 使 


用 第 二 种 方法 ,字符 集 转换 (使 用 基于 wxMBConv 的 wxCSConv). 


wxEncodingConverter 


这 种 方法 只 能 支持 部 分 的 字符 集 , 但 是 如 果 你 的 编译 器 不 支持 wchar _t 结 构 , 这 是 你 唯一 的 选 # 


转换 方法 如 下 : 


wxEncodingConverter converter(enc, alternative, wxCONVERT_SUBSTITUTE) ; 


text = converter.Convert(text); 


$, 


wxCONVERT_SUBSTITUTE 标 记 表 明 人 允许 转换 过 程 中 如 果 找 不 到 严格 对 应 的 字符 ,允许 存在 
信息 损失 , 这 将 导致 带 重音 符号 的 字母 变 成 普通 的 字母 或 者 短 破 折 号 和 长 破 折 号 统一 用 "-" 来 代 
蔡 等 . 


wxCSConv (wxMBConv) 


Unicode 的 解决 方案 的 核心 是 , 它 使 用 16bit 或 者 甚至 是 32bit 的 wchar_t 结 构 来 代表 一 个 字符 , 因 
此 它 可 以 把 全 世界 所 有 的 字符 用 一 种 编码 表示 .这 意味 着 你 不 需要 义理 任何 编码 转换 之 类 的 问 
题 除非 你 需要 义理 老 的 8-bit 格 式 数 据 , 前 面 我 们 已 经 说 过 ,8bit 的 数据 必须 和 字符 集 一 起 使 用 才 


=z 、 
TAL. 


即使 你 没有 把 wxWidgets 编 译 成 Unicode 模 式 ( 这 种 模式 下 ,所 有 的 字符 串 都 是 Unicode 编 码 格 
式 ), 只 要 你 的 系统 支持 ,你 还 是 可 以 使 用 它 进行 编码 转换 .转换 的 方法 是 , 先 把 你 的 字符 串 从 它 的 
编码 转换 成 Unicode 编 码 ,然后 再 从 Unicode 编 码 转换 成 目标 编码 . WXString 类 也 使 用 这 种 方法 
来 提供 编码 转换 支持 .要 记 住 的 是 : 非 Unicode 版 本 的 wxWidgets 中 的 wxString 对 象 采用 的 是 8bit 
的 方法 保存 字符 串 ,因此 它 自己 并 不 知道 其 内 部 的 数据 使 用 的 是 什么 编码 方式 . 


an SR 48 FE wxString 44 + AK Unicode, (Kz = 18 AwxString::wc_strBs ay, a CNAA TTE 
转换 类 作为 它 的 参数 ,这 个 参数 告诉 非 Unicode 版 本 的 wxString 它 内 部 的 字符 串 是 采用 什么 编码 
方式 的 ,但 是 在 Unicode 版 本 的 wxWidgets 中 , 这 个 参数 被 忽略 ,因为 wxString 内 部 的 编码 已 经 是 
Unicode T. 


在 Unicode 版 本 中 ,我 们 可 以 直接 使 用 wx_str 返 回 的 字符 串 了 ,但 是 在 非 Unicode 版 本 中 ,我 们 还 
需要 将 其 转换 为 我 们 可 以 支持 的 编码 方式 convTo, 因 此 在 下 面 的 代码 中 ,在 Unicode 版 本 
中 ,convTo 也 将 被 忽略 : 


text = wxString(text.wc_str(convFrom), convTo); 


可 以 看 到 字符 集 编码 比 字体 字体 编码 更 常 使 用 ,因此 有 时 候 你 需要 通过 下 面 的 代码 将 字体 编码 
名 字 装 换 成 字符 集 编码 名 字 : 


wxFontMapper: :GetEncodingName(fontencoding); 


这 就 是 上 面 例子 中 下 面 这 一 部 分 代码 的 含义 : 


wxCSConv convFrom(wxFontMapper::GetEncodingName(enc)); 
wxCSConv convTo(wxFontMapper: :GetEncodingName(alternative) ); 
text = wxString(text.wc_str(convFrom) , convTo) ; 


有 时 候 你 需要 直接 使 用 8bit 的 字 节 流 而 不 是 使 用 wxString, 这 可 以 通过 使 用 wxCharBuffer 类 获 
得 ,下 面 我 们 看 看 这 一 行 代码 : 


wxCharBuffer output = convTo.cWC2MB(text.wc_str(convFrom) ); 


如 果 你 的 输入 数据 不 是 一 个 字符 串 而 也 是 一 个 8bit 的 数据 流 (比如 也 是 一 个 wxCharBuffer), 你 可 
以 使 用 下 面 的 转换 方式 : 


wxCharBuffer output = convTo.cWC2MB(convFrom.cMB2WC(input)); 


wxWidgets 定 义 了 一 些 全 局 的 类 用 于 实现 字符 转换 ,比如 wxConvISO8859_1 是 一 个 对 象 ,而 
wxConvCurrent 是 一 个 指针 ,指向 当前 标准 C 的 locale 指 定 的 编码 类 .另外 还 有 一 些 wxMBConv 
的 子 类 用 来 优化 特定 的 编码 转换 任务 ,比如 wxMBConvUTF7,wxMBConvUTF8, 
wxMBConvUTF16LE/BE 和 wxMBConvUTF32LE/BE. 其 中 后 两 个 被 重 定义 为 
wxMBConvUFT16/32, 它 使 用 机 器 本 身 的 字 节 序 . 更 多 信息 请 参考 wxWidgets 手 册 中 

的 "wxMBConv Classes Overview" 小 节 . 


转化 来 自 外 部 的 临时 缓存 数据 


多 数 的 转换 结果 为 一 个 新 创建 的 字符 串 或 者 一 个 临时 缓存 .有 时 候 我 们 需要 将 转换 的 结果 保存 
起 来 已 各 以 后 使 用 ,这 种 情况 下 我 们 可 以 把 转换 的 结果 复制 到 一 个 独立 的 存储 区 . 


假设 我 们 想 在 两 个 电脑 之 间 通 过 socket 传 递 字 符 串 .我 们 首先 应 该 在 字符 串 采 用 的 编码 上 取得 
一 致 .否则 ,平台 默认 的 编码 可 能 把 传递 的 字符 串 搞 的 一 团 糟 .在 我 们 的 这 个 例子 中 ,我 们 把 发 送 
出 去 的 字符 串 先 转换 成 UTF-8 编 码 , 在 接收 的 部 分 ,在 将 UTF-8 编 码 的 字符 串 转 换 成 系统 默认 的 
字符 串 . 


下 面 的 代码 演示 了 怎样 将 符合 本 地 编码 的 字符 串 转 换 成 UTF-8, 将 转换 结果 存储 在 一 个 char 指 
针 中 ,然后 通过 socket 发 送出 去 ,接收 的 电脑 再 将 收 到 的 字符 串 从 UTF-8 转 换 成 它 自己 的 电脑 上 
的 本 地 编码 . 


// 将 本 地 编码 字符 串 转换 成 UTF-8 编 码 
const wxCharBuffer ConvertToUTF8(wxString anyString) 


return wxConvUTF8.cWC2MB( anyString.wc_str(*wxConvCurrent) ) ; 


} 
// 将 UTF-8 编 码 的 字符 串 转换 成 本 地 编码 字符 串 
wxString ConvertFromUTF8(const char* rawUTF8) 


return wxString(wxConvUTF8.cMB2WC(rawUTF8), *wxConvCurrent); 


} 
// 测试 以 下 这 两 个 转换 画 数 
void StringConversionTest(wxString anyString) 


// 转化 成 UTF-8 编 码 并 保存 在 wxCharBuffer 中 ， 

const wxCharBuffer bUTF8 = ConvertTOUTF8(anyString) ; 
// wxCharBuffer 可 以 隐 式 的 转换 成 char*. 

const char *cUTF8 = bUTF8 ; 

// 重建 字符 串 

wxString stringCopy = ConvertFromUTF8(cUTF8); 

// 因为 是 同一 个 电脑 , 这 两 个 字符 串 应 该 是 完全 相同 的 . 
wxASSERT(anyString == stringCopy); 


帮助 文件 


你 需要 为 每 个 支持 的 语言 制作 一 份 帮助 文件 .你 的 帮助 文件 控制 器 在 初始 化 的 时 候 将 指定 帮助 
文件 的 名 称 . 你 可 以 使 用 wxLocale::GetName 来 获取 语言 相关 的 名 称 , 也 可 以 直接 使 用 前 面 介 绍 
的 _() 宏 以 便 获 得 语言 相关 的 名 称 . 比 如 : 


m_helpController->Initialize(_("help_english") ); 


如 果 你 使 用 的 是 wxHtmlHelpController, 记 住 你 需要 给 每 一 个 帮助 页 面 指定 META 标 记 , 如 下 所 
示 : 


<meta http-equiv="Content-Type" content="text/html; charset=iso8859 //2"> 
你 还 需要 注意 帮助 工程 文件 (扩展 名 .hhp) 也 许 要 包含 一 个 指定 编码 的 选项 行 : 


Charset=iso8859-2 


这 个 额外 的 条 目 告诉 HTML 帮 助 控制 器 帮助 内 容 和 帮助 索引 使 用 什么 编码 格式 编码 的 . 


16.4 数字 和 日 期 


本 地 化 程序 中 的 另外 一 个 方面 是 格式 化 数字 和 日 期 ,对 于 数字 ,基于 printf 的 wxString 格 式 化 函数 
已 经 在 内 部 实现 了 针对 不 同 地 域 的 本 地 化 ,如 下 面 的 代码 所 示 : 


wxString::Format (wxT("%.1f") , myDouble); 
这 里 ,Format 函 数 将 会 根据 你 设置 的 locale 帮 你 处 理 地 域 差异 . 而 下 面 的 日 期 格式 化 代码 : 


wxDateTime t = wxDateTime: :Now(); 
wxString str = t.Format(); 


Format 2X tb HRR i E Mlocale #47 A E SCHR TE. ZewxWidgets+ ft # af i 40 A HAS 
数 格 式 化 的 相关 部 分 详细 的 介绍 了 怎样 根据 自 定义 的 格式 进行 时 间 和 日 期 的 格式 化 .在 这 种 情 


况 下 ,你 只 需要 将 格式 化 文本 使 用 _() 宏 包括 起 来 ,然后 针对 不 同 的 语言 翻译 成 对 应 的 本 地 格式 就 
可 以 了 . 


如 果 你 想 知道 当前 设置 的 locale 对 应 的 数字 分 割 符 或 者 别 的 一 些 本 地 化 相关 的 值 ,可 以 使 用 
wxLocale 的 Getlnfo 函 数 ,比如 下 面 的 代码 返回 当前 设置 的 locale 下 数字 的 10 进 制 分 割 符 : 


wxString info = m_locale.GetInfo(wxLOCALE_THOUSANDS_SEP, 
wxLOCALE_CAT_NUMBER) ; 


16.5 其 它 媒介 


你 可 以 使 用 和 文本 同样 的 机 制 来 针对 不 同 的 语言 加 载 不 同 的 声音 和 图 片 ,如 下 所 示 : 
wxBitmap bitmap(_("flag.png")); 
上 面 的 代码 将 导致 flag.png 在 运行 期 被 翻译 ,因此 你 可 以 将 其 针对 不 同 的 语言 翻译 成 不 同 的 文 


流 " 中 介绍 的 技术 将 其 翻译 为 一 个 虚拟 文件 系统 路 笃 . 


wxWidgets 跨 平台 GUI 编程 


16.6 一 个 小 例子 


为 了 演示 本 章 介 绍 的 这 些 内 容 , 随 书 光盘 上 examples/chap16 目 录 中 举 了 一 个 小 例子 . 它 以 三 种 
语言 显示 了 一 些 字符 串 和 图 片 :英语 ,法 语 和 德语 . 你 可 以 从 文件 菜单 更 改 当前 的 语言 ,这 将 导致 
菜单 字符 串 ,静态 文本 控件 和 使 用 的 图 片 作出 相应 的 改变 .为 了 演示 _() 宏 和 wxT() 的 区 别 , 状 态 栏 
的 字符 串 始 终 保持 英语 不 变 . 


nmilBnwxWideets App aAA «= 116m wxWidgets App DOR 


face Aide =m Help 


Changer de langue... Change language... 
Quitter ALT-F4 | Exit Alt-X | 


ll est 27/02/2005 12:54:24 maintenant Now is 27/02/2005 04:52:37 


12345 divisé par 10 est écrit comme 1234,5 12345 divided by 10 is written as 1234.5 





这 个 例子 的 应 用 程序 类 包含 一 个 指向 wxLocale 类 型 的 指针 和 一 个 画 数 SelectLanguage 用 来 更 
改 当 前 的 语言 .主要 的 声明 和 实现 如 下 : 


16.6 一 个 小 例子 439 


主 
分 
字 


class MyApp : public wxApp 


public: 

~MyApp() ; 

// 初始 化 应 用 程序 

virtual bool OnInit(); 

// 根据 用 户 选 择 的 语言 重新 创建 wxLocale 变 量 

void SelectLanguage(int lang); 
private: 

wxLocale* m_locale; // 'our' locale 


IMPLEMENT_APP(MyApp) 
bool MyApp: :OnInit() 


wxImage: :AddHandler( new wxPNGHandler ); 

m_locale = NULL; 

SelectLanguage( wxLANGUAGE_DEFAULT ); 

MyFrame *frame = new MyFrame(_("ii8n wxWidgets App")); 
frame->Show(true); 

return true; 


void MyApp::SelectLanguage(int lang) 


delete m_locale; 
m_locale = new wxLocale( lang ); 
m_locale->AddCatalog( wxT("ii8n") ); 
} 
ae : :~MyApp() 


delete m_locale; 


窗口 的 两 个 函数 SetupStrings 和 OnChangeLanguage 可 能 是 你 最 感 兴趣 的 部 
,SetupStrings 更 改 相关 控件 的 字符 串 并 且 重 新 创建 菜单 条 ,以 便 演 示 更 改 wxLocale 以 后 相关 
符 串 的 翻译 : 


void MyFrame: :SetupStrings() 


m_helloString->SetLabel(_("Welcome to International Sample")); 
m_todayString->SetLabel( wxString::Format(_("Now is %s") , wxDateTime: :Now().Format() 
-c_str() ) ); 
m_thousandString->SetLabel( wxString: :Format(_("12345 divided by 10 is written as % 
saat) , sev }) ie 
m_flag->SetBitmap(wxBitmap( _("flag.png") , wxBITMAP_TYPE_PNG )); 
// 创建 菜单 条 
wxMenu *menuFile = new wxMenu; 
// About 菜 单 应 该 位 于 帮助 菜单 
wxMenu *helpMenu = new wxMenu; 
helpMenu->Append(wxID_ABOUT, _("&About...\tF1i"), 
wxT( "Show about dialog")); 
menuFile->Append(wxID_NEW, _("Change language..."), 
wxT("Select a new language") ); 
menuFile->AppendSeparator(); 
menuFile->Append(wxID_EXIT, _("E&xit\tAlt-X"), 
wxT("Quit this program")); 
wxMenuBar *menuBar = new wxMenuBar(); 
menuBar ->Append(menuFile, _("&File")); 
menuBar ->Append(helpMenu, _("&Help")); 
wxMenuBar* formerMenuBar = GetMenuBar(); 
SetMenuBar (menuBar ) ; 
delete formerMenuBar; 
SetStatusText(_("Welcome to wxWidgets!")); 








OnChangeLanguage 在 用 户 更 改 当 前 语言 的 时 候 被 调用 , 它 将 用 户 的 选择 映射 到 某 种 语言 标 识 
(比如 wxLANGUAGE_GERMAN) 上 .这 个 标识 被 传递 给 MyApp::SelectLanguage 以 便 设 置 当 前 
的 locale, 然 后 调用 SetupStrings 根 据 设置 的 locale 更 改 当 前 的 字符 串 和 图 片 ,如 下 所 示 : 


void MyFrame: :OnChangeLanguage(wxCommandEvent& event) 

{ 
wxArrayInt languageCodes; 
wxArrayString languageNames; 
languageCodes .Add(wxLANGUAGE_GERMAN) ; 
languageNames.Add(_("German") ); 
languageCodes .Add(wxLANGUAGE_FRENCH) ; 
languageNames.Add(_("French") ); 
languageCodes.Add(wxLANGUAGE_ENGLISH) ; 
languageNames.Add(_("English")); 
int lang = wxGetSingleChoiceIndex( _("Select language:"), 

_("Language"), languageNames ); 

if ( lang != -1 ) 


wxGetApp().SelectLanguage(languageCodes[lang]); 
SetupStrings(); 
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第 十 六 草 小 结 

本 章 我 们 介绍 了 怎样 处 理 字符 串 , 时 间 , 日 期 ,货币 等 在 不 同 语言 之 间 的 翻译 .最 后 的 忠告 是 :你 应 
该 和 一 个 熟悉 那个 国家 语言 的 人 一 起 作 这 个 事情 ,才能 了 解 到 不 同 语言 之 间 一 些 细微 的 差别 . 


wxWidgets 自 带 的 samples/internat 目 录 中 也 有 一 个 相关 的 例子 , 它 将 使 用 到 的 字符 串 翻译 成 了 
十 种 语言 . 


下 一 章 里 ,我 们 将 学 习 怎 样 让 你 的 应 用 程序 通过 多 线程 的 方法 同时 处 理 多 个 任务 . 


第 十 七 章 编写 多 线程 程序 


大 多 数 时 候 , 事 件 驱动 的 GUI 程序 可 以 给 你 造成 一 个 很 好 的 假象 :多 个 任务 在 同时 的 运行 .这 是 因 
为 , 重 绘 窗口 通常 只 占用 很 少 的 时 间 , 用 户 输入 也 被 很 快 的 进行 了 处 理 .然后 ,有 时 候 , 有 些 任务 很 
难 将 其 分 割 成 足够 小 的 让 人 难以 察觉 的 小 块 来 运行 ,这 时 候 就 要 使 用 多 线程 编程 了 .本 章 我 们 来 
介绍 一 下 在 wxWidgets 中 怎样 实现 多 线程 编程 .在 本 章 的 最 后 ,我 们 将 介绍 一 下 多 线程 编程 的 一 
BERS KARA. 


17.1 什么 时 候 使 用 多 线程 ,什么 时 候 不 要 使 用 


线程 基本 上 来 说 是 你 的 应 用 程序 中 一 条 单独 的 执行 路 径 . 有 些 地 方 把 线程 成 为 轻 量 级 的 进程 ,但 
是 线程 和 进程 有 着 一 个 最 本 质 的 区 别 , 那 就 是 :进程 是 在 不 同 的 地 址 空间 运行 的 ,而 同一 个 进程 内 
的 所 有 的 线程 都 在 同一 个 地 址 空间 运行 . 当然 这 样 的 好 处 是 ,同一 个 进程 的 线程 互相 访问 公共 的 
数据 是 非常 方便 的 ,不 过 这 也 造成 了 另外 一 个 经 常 犯错 误 的 地 方 ,就 是 很 一 个 数据 很 容易 被 多 个 
线程 同时 访问 ,造成 不 可 知 的 后 果 , 因 此 强烈 推荐 对 于 这 些 数据 的 访问 ,必须 小 心 的 使 用 用 于 同步 
变量 访问 的 变量 ,比如 信号 量 和 关键 区 域 . 


如 果 使 用 的 当 , 多 线程 编程 可 以 简化 点 用 程序 的 体系 结构 ,并 且 闻 用户 界 面 和 其 后 面 的 真实 世界 
分 割 开 来 .注意 这 通常 不 会 让 你 的 点 用 程序 运行 的 更 快 ,除非 你 有 多 个 处 理 器 ,但 是 用 户 界面 通常 
会 变 得 更 灵敏 


WwWxVWidgets 既 提供 了 线程 的 支持 ,也 提供 了 信号 量 和 带 条 件 的 关键 区 域 的 支持 .其 线程 API 主 要 
参考 的 是 pthread(POSIX 线 程 ) 模 型 ,不 过 某 些 API 采 用 了 不 同 的 名 字 , 而 另外 一 些 API 则 吸收 了 部 
分 Win32 线 程 API 的 灵感 . 


这 些 类 使 得 编写 多 线程 的 程序 变 得 简单 ,并 且 还 提供 了 相对 于 本 地 线程 API 更 多 的 错误 检查 . 尽 
管 如 此 ,多 线程 编程 仍然 不 是 一 个 很 简单 的 事情 ,对 于 大 型 的 项 目 尤其 如 此 .因此 ,在 考虑 编写 新 
的 多 线程 程序 或 者 在 旧 的 代码 中 加 入 多 线程 之 前 ,仔细 的 考虑 一 下 是 不 是 应 该 采取 可 选 的 替代 
方案 来 实现 同样 的 功能 ,是 一 件 很 值得 一 做 的 事情 .在 有 些 情 况 下 ,线程 是 唯一 最 优 的 选择 ,比如 
对 于 一 个 FTP 服 务 器 来 说 ,为 每 一 个 新 的 连接 创建 一 个 线程 ,但 是 ,如 果 只 是 增加 一 个 线程 来 为 某 
个 长 时 间 的 运算 显示 一 个 进度 条 来 说 ,这 种 线程 的 时 候 就 有 点 过 犹 不 及 了 .在 这 种 情况 下 ,你 可 以 
将 计算 任何 放 在 系统 空闲 的 时 候 进 行 ,并 且 周 期 性 的 调用 wxWindow::Update 来 更 新 用 户 界面 就 
可 以 了 .关于 这 个 问题 更 详细 的 描述 ,请 参考 本 章 的 最 后 一 节 ," 多 线程 的 替代 方案 "中 的 描述 . 


如 果 你 还 是 决定 在 你 的 代码 中 使 用 多 线程 ,我 们 强烈 建议 你 只 在 你 的 主线 程 中 调用 所 有 和 GUI 

有 关 的 函数 .尽管 wxWidgets 自 带 的 线程 例子 中 演示 了 怎样 在 多 个 线程 中 同时 调用 GUI 函 数 ,但 
是 ,一 般 来 说 ,这 是 非常 非常 差劲 的 设计 .一 个 主线 程 负责 GUI 其 它 多 个 线程 负责 别 的 计算 工作 ， 
他 们 之 间 通 过 事件 互相 通讯 ,这 样 的 设计 是 更 好 的 设计 并 且 通 常 可 以 避免 很 多 的 错误 从 而 节约 
你 大 量 的 调试 的 时 间 .比如 说 ,在 Win32 平 台 上 ,线程 只 能 使 用 由 自己 而 不 是 别 的 线程 创建 的 GUI 
对 象 (画笔 , 画 刷 之 类 ). 


要 实现 线程 之 间 通 讯 ,你 可 以 使 用 wxEvtHandler::AddPendingEvent 郴 数 或 者 它 的 简化 版 本 
wxPostEvent, 这 些 函 数 被 设计 成 线程 安全 的 因此 你 可 以 使 用 他 们 在 线程 之 间 发 送 事件 . 


17.2 使 用 wxThread 


如 果 你 要 在 你 的 代码 中 使 用 线程 ,首先 要 实现 一 个 wxThread 的 派生 类 ,并 且 至 少 要 重 载 其 虚 西 
数 Entry, 这 个 男 数 包含 了 线程 要 做 的 主要 的 事情 .举例 来 说 ,比如 我 们 要 用 一 个 单独 的 线程 来 计 
算 图 片 中 颜色 的 数目 ,下 面 是 我 们 的 派生 类 的 声明 : 


class MyThread : public wxThread 


{ 
public: 
MyThread(wxImage* image, int* count): 
m_image(image), m_count(count) {} 
virtual void *Entry(); 


private: 
wxImage* m_image; 
int* m_count; 
J; 


// 一 个 标识 符 用 来 在 线程 工作 完成 的 时 候 通知 应 用 程序 
#define ID_COUNTED_COLORS 100 


Entry Na A RATHA LIHER —MRE A(T RARE (BLT 2 ), Waitt BUS Elx 
Mi), Fe 1 NEntrye Re: 


void *MyThread: :Entry() 


{ 
(* m_count) = m_image->CountColours(); 
// 使 用 一 个 已 知 的 事件 来 通知 应 用 程序 . 
wxCommandEvent event (wxEVT_COMMAND_MENU_SELECTED, 
ID_COUNTED_COLORS); 
wxGetApp().AddPendingEvent(event); 
return NULL; 
} 


了 简单 起 见 ,我 们 没有 定义 新 的 事件 而 是 使 用 了 一 个 已 有 的 事件 通知 应 用 程序 线程 的 工作 已 
oo 
线程 的 创建 
线程 的 创建 分 为 两 步 ,首先 产生 一 个 线程 的 实例 ,然后 调用 线程 的 Create 函 数 : 


MyThread *thread = new MyThread(); 
if ( thread->Create() != wxTHREAD_NO_ERROR ) 


{ 
} 


wxLogError(wxT("Can't create thread!")); 


有 两 种 不 同 的 线程 ,一 种 线程 你 在 启动 之 后 就 可 以 忘记 它 的 存在 ,而 另外 一 种 ,你 需要 等 待 它 返回 
一 个 结果 .前 者 我 们 称 为 分 离线 程 ,后 者 称 为 联合 线程 . 线程 的 类 型 是 通过 调用 wxThread 的 构造 
本 数 时 传递 的 参数 是 wxTHREAD_DETACHED 还 是 wxThrEAD_JOINABLE 来 决定 的 ,联合 线程 
的 返回 值 是 由 对 其 成 员 画 数 Wait 的 调用 返回 的 ,而 对 于 分 离线 程 ,不 可 以 调用 Wait 辑 数 . 


你 不 必 把 所 有 的 线程 都 创建 为 联合 线程 ,因为 联合 线程 有 它 不 方便 的 地 方 ,你 必须 调用 联合 线程 
的 Wait 函 数 来 等 待 联合 线程 结束 ,否则 系统 为 这 个 线程 分 配 的 所 有 的 资源 将 不 会 被 释放 ,并 且 你 
还 需要 自己 删除 这 个 线程 对 象 (尽管 这 个 对 象 只 能 使 用 一 次 ). 而 分 离线 程 则 具有 "点 火 以 后 就 忘 

掉 " 的 特性 ,你 只 需要 启动 它 , 它 将 自己 自己 中 止 和 释放 . 


当然 ,这 也 意味 者 分 离线 程 必 须 在 堆 上 创建 ,因为 它 将 在 结束 的 时 候 调 用 delte(this). 联 合 线程 既 
可 以 在 栈 上 创建 也 可 以 在 堆 上 创建 ,不 同 通常 也 都 是 在 堆 上 创建 的 .不 要 创建 全 局 的 线程 对 象 , 因 
为 他 们 将 在 他 们 的 构造 范 数 执行 的 时 候 分 配 内 存 ,这 将 导致 内 存 检测 系统 出 现 一 些 问题 . 


指定 栈 大 小 
你 可 以 在 调用 线程 的 Create 函 数 的 时 候 指 定 它 的 栈 大 小 ,默认 的 0 代表 使 用 操作 系统 默认 的 大 


小 . 
指定 优先 级 


某 些 操作 系统 允许 应 用 程序 自己 提供 一 个 线程 的 优先 级 (时 间 片 的 大 小 ), 你 可 以 通过 
wxThread::SetPriority 函 数 来 达到 这 个 目的 .优先 级 的 数值 在 0 到 100 之 间 ,0 为 最 低 优 先 级 而 100 
为 最 高 优先 级 ,不 过 最 好 使 用 预定 义 的 宏 wxTHREADMIN_PRIORITY 
wxTHREAD_DEFAULT_PRIORITY 和 wxTHREAD_MAX PRIORITY, 他 们 的 值 分 别 为 0,50 和 
100.SetPriority 画 数 应 该 在 调用 Create 之 后 ,调用 Run 画 数 之 前 被 调用 . 


启动 线程 


调用 Create 函 数 以 后 ,线程 还 没有 开始 运行 ,你 还 需要 调用 wxThread::Run 辑 数 来 启动 线程 ,这 个 
函数 将 会 调用 你 自 定 义 的 Entry 本 数 . 


怎样 暂停 线程 以 等 待 一 个 外 部 条 件 


如 果 线 程 需要 等 待 某 些 事情 发 生 ,你 应 该 避免 直接 使 用 查询 和 什么 事 都 不 做 这 样 的 循环 ,这 会 让 
你 的 程序 "忙于 等 待 ", 白 白浪 费 CPU 的 时 间 . 


如 果 你 需要 等 待 几 秒 钟 ,你 可 以 使 用 wxThread::Sleep 加 数 . 


如 果 你 正在 等 待 什么 事情 发 生 , 你 应 该 使 用 一 种 调用 来 阻止 当前 线程 执行 直到 你 收 到 事情 已 经 
发 生 的 通知 .例如 ,如 果 你 在 线程 中 使 用 了 socket, 你 应 该 阻塞 在 socket 的 系统 调用 上 ,直至 
socket 收 到 数据 ,这 就 不 会 白白 浪费 CPU 了 ,或 者 如 果 你 正在 等 待 一 个 联合 线程 使 用 的 数据 ,你 可 
以 调用 Wait 其 函数 来 阻塞 自己 . 


有 时 候 你 可 能 会 想 用 线程 的 Pause 和 Resume 画 数 来 临时 将 你 的 线程 置 入 睡眠 状态 ,但 是 这 样 做 
有 两 个 问题 ,首先 ,暂停 机 制 不 是 所 有 的 系统 都 支持 ,有 些 系统 (尤其 是 POSIX 标 准 的 系统 ) 的 
Pause 是 模拟 的 ,线程 必须 调用 TestDestroy 并 且 在 这 个 函数 返回 True 的 时 候 立 刻 中 断 自己 的 运 
行 .第 二 个 问题 是 ,调用 Pause 的 线程 有 时 候 很 难 回复 正常 运行 ,因为 这 使 得 操作 系统 可 能 在 任何 
时 候 中 止 你 的 线程 的 运行 ,如 果 你 的 线程 正在 锁定 一 个 信号 量 ,很 可 能 来 不 及 释放 这 个 信号 量 导 
致 出 现 死 锁 . 


因此 ,使 用 Pause 和 Resume 并 不 是 一 个 很 好 的 设计 ,你 应 该 尽 可 能 使 用 信号 量 或 者 关键 区 域 ( 参 
见 下 一 小 节 ) 来 重新 设计 你 的 代码 . 


线程 中 止 


正如 前 面 我 们 谈 到 的 那样 ,分 离线 程 是 自动 结束 和 释放 自己 的 .而 对 于 联合 线程 ,你 可 以 简单 的 调 
用 wxThread::Wait 画 数 .或 者 在 一 个 GUI 程 序 中 ,你 可 以 在 系统 空 闪 事件 处 理 琅 数 中 调用 
wxThread::lsAlive 函 数 ,然后 仅 在 lsAlive 返 回 False 的 时 候 调用 Wait 函 数 .Wait 函 数 是 释放 联合 
线程 资源 的 唯一 的 方法 . 


你 可 以 调用 wxThread::Delete 来 请 求 删 除 一 个 线程 ,不 过 要 让 它 工作 正常 ,你 需要 在 你 的 线程 中 
周期 性 的 调用 TestDestroy 函 数 ( 译 者 注 :根据 经 验 ,在 Windows 平 台 上 ,对 于 联合 线程 使 用 这 种 方 
法 好 像 不 是 一 个 好 主意 )， 


17.3 用 于 线程 同步 的 对 象 


在 几乎 所 有 的 线程 使 用 中 ,数据 都 是 几 个 线程 共享 的 . 当 有 两 个 或 以 上 的 线程 试图 访问 同一 个 数 
据 的 时 候 , 无 论 这 个 数据 是 一 个 对 象 还 是 一 个 资源 ,这 种 访问 都 应 该 被 同步 ,以 避免 数据 在 同一 时 
刻 被 超过 1 个 线程 访问 或 者 修改 .因为 应 用 程序 中 充满 了 所 谓 的 不 变量 ,比如 ,对 于 一 个 链表 来 说 ， 
我 们 总 认为 它 的 第 一 个 元 素 是 有 效 的 ,每 个 元 素 都 指向 它 的 下 一 个 元 素 , 最 后 的 一 个 元 素 是 空 指 
针 . 但 是 在 对 链表 进行 插入 新 元 素 操作 的 时 候 , 有 一 小 段 时 间 间 陋 ,这 个 所 谓 不 变量 是 被 打破 的 . 
这 时 候 假如 有 两 个 线程 同时 在 使 用 这 个 链表 ,如 果 没 有 进行 数据 同步 的 动作 ,就 会 出 现 不 可 知 的 
问题 .因此 你 必须 保证 ,在 你 插入 元 素 这 一 小 段 时 间 间 隔 内 ,没有 别 的 线程 在 访问 同样 的 数据 . 


保证 所 有 的 共享 数据 被 各 个 访问 它 的 线程 快速 的 并 且 是 以 一 个 合理 的 顺序 访问 是 程序 员 自 己 
的 责任 .因此 这 一 小 节 我 们 来 介绍 一 下 wxWidgets 提 供 了 哪些 类 来 帮助 程序 员 达 到 这 个 目的 . 


wxMutex 


这 个 名 字 来 源 于 mutual exclusion( 共 有 的 互 斥 量 ), 它 是 最 简单 的 一 种 数据 同步 手段 . 它 可 以 保证 
同一 个 时 刻 只 有 一 个 线程 在 访问 某 一 部 分 数据 .要 获取 数据 的 访问 权 , 线 程 必须 调用 
wxMutex::Lock 画 数 ,这 将 阻塞 当前 线程 的 执行 直到 它 所 请 求 的 数据 已 经 不 再 有 任何 别 的 线程 使 
用 .而 在 它 开始 使 用 这 个 数据 以 后 , 别 的 线程 对 wxMutex::Lock 的 调用 同样 将 被 阻塞 ,直至 当前 使 
用 的 线程 调用 wxMutex::Unlock 画 数 释放 它 所 使 用 的 资源 .尽管 你 可 以 直接 使 用 wxMutex 的 
Lock 和 Unlock 画 数 ,我 们 还 是 推荐 你 使 用 wxMutexLocker 类 来 使 用 wxMutex, 这 将 确保 你 不 会 忘 
记 在 Lock 以 后 调用 Unlock 画 数 ( 译 者 注 :你 可 以 想像 假如 你 忘 了 Unlock 的 后 果 , 呵 呵 ), 因 为 这 两 个 
Px SLAW FS Heke CE wxMutexLocker 2 BY 44376 BN BUA AT 449 BS BFA, IE, BY eB ET 

常 ,wxMutexLocker 类 仍然 会 在 自己 被 释放 的 时 候 进 行 Unlock. 


下 面 的 代码 中 ,我 们 确信 MyApp 有 一 个 wxMutex 类 型 的 变量 m_mutex: 


void MyApp::DoSomething() 
{ 


wxMutexLocker lock(m_mutex); 
if (lock.IsOk()) 


{ 
. do something 
} 
else 
{ 
. we have not been able to 
. acquire the mutex, fatal error 
} 


使 用 互 斥 量 有 三 个 重要 的 规则 : 


1 线程 不 可 以 锁定 已 经 被 锁定 的 互 斥 量 (不 允许 互 斥 量 递 当 ). 尽管 有 些 系统 允许 你 这 样 做 ,但 
这 是 不 可 移植 的 . 
2， 线 程 不 允许 解锁 别 的 线程 锁定 的 互 斥 量 . 如 果 你 需要 这 个 功能 ,参考 我 们 马上 会 讲 到 的 信号 


量 机 制 |. 

3， 如 果 你 的 线程 即使 无 法 锁定 互 斥 量 也 还 有 别 的 事情 可 以 做 ,你 应 该 先 使 用 
wxMutex::TryLock 本 数 判断 是 否 可 以 锁定 .这 个 函数 是 立即 返回 的 ,返回 值 为 可 以 锁定 
(wxMUTEX_NO_ERROR) 或 者 不 可 锁定 (wxMUTEX_DEAD_LOCK 或 
wxMUTEX_BUSY). 这 在 主线 程 中 尤其 有 用 ,因为 主线 程 (GUI 线程 ) 是 不 可 以 被 阻塞 的 ,否则 
它 将 不 能 响应 任何 用 户 的 输入 . 


死 锁 


如 果 两 个 线程 在 互相 等 待 对 方 已 经 锁定 的 互 斥 量 ,我 们 称 之 为 发 生 了 死 锁 .举例 来 说 ,假如 线程 A 
已 经 锁定 了 互 斥 量 1, 线 程 B 已 经 锁定 了 互 斥 量 2, 线 程 A 正 等 待 锁定 互 斥 量 2, 而 线程 B 正 等 待 锁定 
互 斥 量 1, 那 么 ,他 们 两 个 人 将 无 限期 的 等 待 下 去 ,在 某 些 系 统 上 ,如 果 出 现 这 种 情况 ,Lock 或 者 
Unlock 或 者 TryLock 画 数 将 返回 错误 码 WxMUTEX_DEAD_LOCK, 但 是 在 另外 一 些 系 统 上 ,除非 
你 把 整个 程序 杀 死 ,否则 他 们 将 一 直 等 下 去 . 


解决 死 锁 的 方法 有 一 下 两 种 : 


。 修改 顺序 .一 个 一 致 的 互 斥 量 锁定 顺序 将 减少 死 锁 发 生 的 概率 .在 前 面 的 例子 中 ,如 果 线 程 A 
和 线程 B 都 要 求 先 锁定 互 斥 量 1 再 锁定 互 斥 量 2, 则 和 死 锁 将 不 会 发 生 . 

e 使 用 TryLock. 在 成 功 锁定 第 一 个 互 斥 量 以 后 ,在 后 续 的 互 斥 量 锁定 之 前 都 使 用 TryLock 函 数 
判断 ,如 果 TryLock 返 回 失 败 ,解锁 第 一 个 然后 重新 开始 锁定 第 一 个 . 这 种 方法 系统 开销 较 大 ， 
但 是 如 果 修改 顺序 的 方法 有 明显 的 缺陷 或 者 导致 你 的 代码 乱七八糟 ,你 可 以 考虑 使 用 这 种 
方法 . 


wxCriticalSection 
关键 区 域 用 来 保证 某 一 段 代 码 在 某 一 个 时 刻 只 被 一 个 线程 执行 ,而 前 面 介 绍 的 互 斥 量 则 用 来 保 


证 互 斥 量 在 某 一 个 时 刻 只 被 一 个 线程 锁定 .他 们 之 间 是 非常 相似 的 ,除了 在 某 些 系统 上 , 互 斥 量 是 
系统 范围 内 的 变量 而 关键 区 域 只 在 本 应 用 程序 范围 内 有 效 .在 这 样 的 系统 上 ,使 用 关键 区 域 的 效 


定 (或 者 装载 ): 和 解锁 (或 者 卸载 ), 而 关键 区 域 称 为 进入 或 者 离开 . 


关键 区 域 也 有 对 应 的 wxCriticalSectionLocker 对 象 ,出 于 和 wxMutexLocker 同 样 的 原因 ,你 应 该 
尽量 使 用 它 而 不 要 直接 使 用 wxCriticalSection 的 男 数 . 


wxCondition 


所 谓 条件 变 量 wxCondition, 是 用 来 指示 共享 数据 的 某 些 条 件 已 经 满足 .比如 ,你 可 以 使 用 它 来 指 
示 一 个 消息 队列 已 经 有 数据 到 来 .而 共享 数据 本 身 ( 在 这 里 指 的 这 个 消息 队列 ) 通 常 还 需要 另外 
使 用 一 个 互 斥 量 来 保护 . 


你 可 以 通过 锁定 互 斥 量 ,检测 队列 有 无 数据 ,然后 释放 信号 量 这 样 的 循环 来 进行 消息 队列 数据 的 
处 理 ,不 过 如 果 队 列 里 一 直 没 有 数据 ,这 样 的 作法 也 太 浪 费 了 ,时 间 全 部 浪费 在 锁定 和 解锁 互 斥 量 
上 面 了 . 象 这 种 情况 ,最 好 是 使 用 条 件 变 量 , 这 桩 消息 义理 线程 就 可 以 被 阻塞 直到 等 到 别 的 线程 把 
事件 放 和 人 事件 队列 以 后 发 出 通知 事件 . 


多 个 线程 可 能 都 在 等 待 同一 个 条 件 ,这 时 你 可 以 选择 唤醒 一 个 线程 还 是 唤醒 多 个 线程 ,唤醒 一 个 
线程 的 范 数 是 Signal, 唤 醒 所 有 正在 等 待 的 线程 的 函数 是 Broadcast. 如 果 有 多 个 条 件 都 是 由 同一 
个 wxCondition 通 知 的 ,你 必须 使 用 Broadcast 画 数 ,否则 可 能 某 个 线程 被 唤醒 了 但 是 却 什么 也 做 
不 了 ,因为 它 的 条 件 还 没有 满足 ,而 另外 的 可 以 满足 条 件 的 那个 线程 却 无 法 唤醒 了 . 
wxCondition 使 用 举例 

我 们 来 假设 一 下 我 们 有 两 个 线程 : 

一 个 是 生产 线程 , 它 负 责 产 生 10 个 元 素 并 且 将 其 放 入 队列 ,然后 发 送 队 列 满 信 号 并 且 在 继续 填充 
元 素 之 前 等 待 队列 空 信号 . 

一 个 是 消费 线程 , 它 在 收 到 队列 满 信 号 的 时 候 移 除 队列 中 所 有 的 元 素 . 


我 们 需要 一 个 互 斥 量 m_mutex, 用 来 保护 整个 队列 和 两 个 条 件 变 量 :m_isFull 和 m_isEmpty. 这 个 
互 斥 量 被 传递 给 两 个 条 件 变量 的 构造 画 数 作为 参数 .另外 你 需要 总 是 显示 判断 条 件 是 否 满足 , 然 
后 再 开始 等 待 通知 ,因为 可 能 在 你 还 没有 开始 等 待 之 前 ,已 经 有 一 个 信号 通知 了 ,由 于 你 还 没有 等 
待 ,那个 信号 就 丢失 了 . 


我 们 来 看 看 生产 线程 的 Entry 玉 数 的 伪 代 码 : 


while ( notDone ) 


wxMutexLocker lock(m mutex) ; 
while( m_queue.GetCount() &gt; 0 ) 
{ 


m_isEmpty.Wait() ; 
for ( int i=0; i &lt; 10 ; ++i ) 
m_queue.Append( wxString::Format(wxT("Element %d"),i) ) ; 


} 
m_isFull.Signal(); 


消费 线程 : 


while ( notDone ) 


wxMutexLocker lock(m_mutex) ; 
while( m_queue.GetCount() == © ) 


m_isFull.wWait() ; 
} 
for ( int i = queue.GetCount() ; i &gt; 0; i) 
{ 


m_queue.RemoveAt( i ) ; 


} 
m_isEmpty.Signal(); 


Wait 范 数 首先 Unlock 其 内 部 的 互 斥 量 ,然后 等 竺 条件 被 通知 . 当 它 被 通知 唤醒 时 ,会 首先 再 次 锁 
定 内 部 的 信号 量 ,因此 数据 同步 时 非常 严格 满足 的 . 


另外 ,在 Wait 范 数 被 唤醒 之 后 再 次 检测 条 件 是 否 满足 也 是 必要 的 ,因为 在 信号 被 发 送 和 线程 被 唤 
醒 之 间 可 能 发 生 某 些 事情 ,导致 条 件 又 一 次 不 满足 了 ;另外 ,系统 有 时 候 也 会 产生 一 些 假 的 信号 导 
致 Wait 函 数 返回 . 


Signal 可 能 在 Wait 之 前 发 生 , 正 象 pthread 中 的 那样 ,这 时 这 个 信号 会 去 失 . 因 此 如 果 你 想 要 确定 
你 没有 错过 任何 信号 ,你 必须 保证 和 条 件 变量 绑 定 的 互 斥 量 在 最 开始 就 多 于 锁定 状态 ,并 且 在 你 
调用 Signal 函 数 之 前 再 次 党 试 锁定 它 ,这 意味 着 对 Signal 的 调用 将 被 阻塞 直到 另外 一 个 线程 调用 
了 Wait 范 数 . 


OK, 上 面 的 这 上 段 话 读 起 来 比较 费劲 ,我 们 来 看 一 个 例子 ,在 这 个 例子 中 ,主线 程 创建 了 一 个 工作 线 
程 ,工作 线程 的 Signal 函 数 直 到 主线 程 调用 了 Wait 以 后 才能 被 调用 : 


class MySignallingThread : public wxThread 


public: 


MySignallingThread(wxMutex *mutex, wxCondition *condition) 


m_mutex = mutex; 
m_condition = condition; 


Create(); 

virtual ExitCode Entry() 

{ 
... GO our job... 
// 告诉 其 它 线程 我 们 马上 就 要 退出 了 . 
// 我 们 必须 先 锁定 信号 量 , 这 个 动作 会 阻塞 自己 
// 直到 主线 程 调用 了 Wait 
wxMutexLocker lock(m_mutex); 
m_condition.Broadcast(); // 我 们 只 有 一 个 线程 在 等 待 , 所 以 等 同 于 Signal( ) 
return 0; 

} 

private: 


}; 


wxCondition *m_condition; 
wxMutex *m_mutex; 


void TestThread() 


{ 


wxMutex mutex; 
wxCondition condition(mutex); 
// 互 斥 量 应 该 先 出 于 锁定 状态 
mutex.Lock(); 
// 先 创建 和 和 运行 工作 线程 , 注意 这 个 线程 不 能 退出 
// 除非 我 们 解锁 了 互 斥 量 
MySignallingThread *thread = 
new MySignallingThread(&mutex, &condition) ; 
thread->Run(); 
// Wait 工 作 线 程 退 出 , Wait 画 数 将 自动 解锁 和 它 绑 定 的 互 斥 量 
// 因此 工作 线程 可 以 继续 直至 发 出 Signal 并 且 终 至 自己 . 
condition.Wait(); 
// 我 们 收 到 了 Signal 就 可 以 退出 了 . 


当然 上 面 的 这 个 例子 指示 出 于 演示 如 何 实现 条 件 变量 中 第 一 个 Singal 在 第 一 个 Wait 之 后 执行 ， 
如 果 单 就 代码 例子 实现 的 功能 来 说 ,我 们 应 该 直接 使 用 一 个 联合 线程 ,然后 在 主线 程 调 用 
wxThread::Join 函 数 就 可 以 了 . 


wxSemaphore 


信号 量 (wxSemaphore) 可 以 通俗 的 看 成 一 个 互 斥 量 和 一 个 记 数 器 的 结合 , 它 和 记 数 器 最 大 的 不 
同 在 于 信号 量 的 值 可 以 被 任何 线程 更 改 ,而 不 仅仅 是 拥有 它 的 那个 线程 .所 以 你 也 可 以 把 信号 量 
看 作 是 一 个 没有 主人 的 记 数 器 . 


如 果 一 个 线程 调用 信号 量 的 Wait 函 数 ,这 个 调用 将 阻塞 ,除非 记 数 器 当前 为 一 个 正 数 ,然后 Wait 函 
数 将 记 数 器 减 一 ,然后 返回 .而 对 Post 函 数 的 调用 则 将 增加 记 数 器 的 值 然后 返回 . 


wxWidgets 实 现 的 信号 量 还 有 一 个 额外 的 特性 ,你 可 以 在 其 构造 范 数 中 指定 一 个 记 数 器 的 最 大 
值 ,默认 为 0 表明 最 大 值 没 有 限制 ,如 果 你 给 定 了 一 个 最 大 值 ,而 Post 函 数 的 调用 使 得 当前 的 记 数 
器 超过 了 这 个 最 大 值 ,你 将 会 得 到 一 个 wxSEMA_OVERFLOW 错 误 .让 我 们 再 回 到 前 面 说 的 用 信 
号 量 实现 特殊 互 斥 的 描述 : 


。 一 个 可 以 被 不 同 的 线程 锁定 和 解锁 的 互 斥 量 可 以 通过 一 个 记 数 器 最 大 值 为 1 的 信号 量 实现 ， 
互 斥 量 的 Lock 豆 数 等 同 于 信号 量 的 Wait 函 数 而 互 斥 量 的 Unlock 函 数 等 同 于 信号 量 的 Post 

。 前 一 个 线程 调用 Lock(Wait) 发 现 是 一 个 整数 值 ,于 是 减 一 ,然后 立即 继续 . 

© 第 二 个 线程 调用 Lock 发 现 是 雳 ,将 必须 等 待 某 个 线程 (不 一 定 是 前 一 个 线程 ) 调 用 
Unlock(Post). 


你 可 以 在 wxWidgets 自 带 的 samples/thread 中 找到 一 个 用 来 演示 多 线程 编程 的 例子 .如 下 图 所 
示 . 在 这 个 例子 中 ,你 可 以 詹 动 ,停止 ,暂停 ,恢复 线程 的 运行 . 它 演示 了 一 个 工作 线程 周期 性 的 通过 
wxPostEvent 往 主 程序 发 送 事件 ,一 个 进度 条 对 话 框 用 来 指示 当前 进度 并 在 进度 到 达 最 后 的 时 
候 取 消 工作 线程 的 运行 . 
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闲 时 间 处 理 或 者 两 者 一 起 使 用 . 


使 用 wxTimer 


wxTimer 类 让 你 的 程序 可 以 周期 性 的 收 到 提示 ,或 者 在 某 个 特定 的 时 间 间 隔 收 到 提醒 .如 果 你 要 
使 用 线程 处 理 的 事情 可 以 分 成 小 的 时 间 片 ,每 隔 几 个 毫秒 处 理 一 次 ,以 便 你 的 应 用 程序 可 以 有 足 
够 的 时 间 响 应 用 户 的 输入 ,你 就 可 以 使 用 wxTimer 来 代替 多 线程 . 


你 可 以 自己 选择 提醒 的 通知 方式 ,如 果 你 更 喜欢 使 用 虚 画 数 ,就 实现 一 个 wxTimer 的 派生 类 ,然后 

重 载 其 Notify 本 数 ,如 果 你 更 倾向 使 用 事件 机 制 ,就 给 你 的 wxTimer 构 造 本 数 指定 一 个 
wxEvtHandler48 H (24 ( FA SetOwner) eH 2X, 7A Ja AEVT_TIMER(id, func) 事 件 映射 宏 来 将 
Be BRAY Bll xt oy BY 4k EN. 


UR A Lh24wxTimer BY 478 SKB SetOwner tN BN 2% — PO AAV EY SRA RRA 
以 用 在 EVT_TIMER 事 件 映射 宏 中 .这 在 你 需要 使 用 多 个 定时 器 的 时 候 比 较 有 用 . 


使 用 Start 函 数 启 动 定时 器 ,需要 传递 的 参数 包括 一 个 毫秒 为 单位 的 定时 器 时 长 和 可 选 的 
wxTIMER_ONE_SHOT 指 示 > \). Stop kj FAK 4 wk SESE at 
器 ,lsRunning 画 数 用 来 检测 当前 定时 器 是 否 出 于 运行 状态 . 


下 面 的 代码 演示 了 怎样 通过 事件 的 方式 使 用 定时 器 :; 


#define TIMER_ID 1000 
class MyFrame : public wxFrame 


public: 


void OnTimer(wxTimerEvent& event); 
private: 
wxTimer m_timer; 


ti 
BEGIN_EVENT_TABLE(MyFrame, wxFrame) 
EVT_TIMER(TIMER_ID, MyFrame: :OnTimer ) 
END_EVENT_TABLE( ) 
MyFrame: :MyFrame() 
: m_timer(this, TIMER_ID) 


// 1 秒 的 间隔 
m_timer.Start(1000); 


void MyFrame: :OnTimer(wxTimerEvent& event) 


// 你 可 以 在 这 里 作 任何 你 希望 1 秒 执行 一 次 的 动作 


注意 这 里 的 时 间 间 陋 很 难 作 到 精确 ,实际 的 间隔 时 长 要 看 定时 器 时 间 义 理 函 数 执行 之 前 发 生 的 
事情 的 忙 闲 状况 而 定 . 


当 我 们 想 精 确 的 测量 时 长 的 时 候 ,wxStopWatch 是 一 个 很 有 用 的 类 , 它 的 构造 画 数 开始 记录 时 间 ， 
你 可 以 暂停 和 恢复 它 以 便 获得 某 个 特定 时 长 的 精确 时 间 . 


wxStopWatch sw; 

SlowBoringFunction(); 

// 暂停 监视 

sw.Pause(); 

wxLogMessage("The slow boring function took %ldms to execute", 
sw.Time()); 

// 恢复 监视 

sw.Resume(); 

SlowBoringFunction(); 

wxLogMessage("And calling it twice took %ldms in all", sw.Time()); 


空间 时 间 处 理 


另外 一 种 代 蔡 多 线程 处 理 的 方法 是 使 用 空闲 时 间 处 理 函 数 .应 用 程序 类 和 所 有 的 窗口 类 在 所 有 
其 它 的 事件 处 理 完 以 后 都 会 收 到 系统 空 闪 事件 ,你 可 以 拦截 这 个 事件 并 增加 自己 的 处 理 画 数 .如 
果 你 希望 收 到 更 多 的 空闲 事件 ,你 可 以 调用 wxldleEvent::RequestMore 画 数 ,否则 一 次 空闲 事件 
义理 完成 以 后 ,要 等 到 下 次 用 户 界面 事件 义理 周期 结束 才 会 再 次 收 到 系统 空闲 事件 .另外 ,通常 你 
还 需要 调用 wxldleEvent::Skip 画 数 ,以 便 别 的 对 象 的 系统 空 闪 事件 处 理 图 数 可 以 被 执行 . 


在 下 面 的 例子 中 ,假想 的 函数 FinishedldleTask 在 每 次 空 亲 事件 处 理 隙 数 中 处 理 一 部 分 工作 ,这 
个 函数 在 整个 工作 完成 以 后 返回 True. 


class MyFrame : public wxFrame 
{ 
public: 
void OnIdle(wxIdleEvent& event); 


// 作 一 小 部 分 工作 , 如 果 做 完 则 返回 True 
bool FinishedIdleTask(); 


ti 

BEGIN_EVENT_TABLE(MyFrame, wxFrame) 
EVT_IDLE(MyFrame: :OnIdle) 

END_EVENT_TABLE( ) 

void MyFrame: :OnIdle(wxIdleEvent& event) 


// TERRE, WMRRARET 

// 再 次 请 求 空闲 事件 

if (!FinishedIdleTask()) 
event.RequestMore(); 

event .Skip(); 


虽然 我 们 的 例子 中 使 用 的 是 frame 窗 口 ,并 不 意味 着 空闲 事件 只 能 存在 于 顶层 窗口 ,实际 上 ,任何 
窗口 都 可 以 处 理 这 个 事件 .比如 ,如 果 你 想 制作 一 个 定制 的 图 像 显 示 控 件 ,如 果 窗 口 大 小 发 生 了 变 
化 ,这 个 控件 只 在 空 闪 事件 才 进 行 重 画 以 避免 窗口 大 小 改变 时 立即 重 画 可 能 引发 的 闪 狼 .为 了 确 
定 这 个 空闲 义理 不 被 点 用 程序 的 空闲 事件 义理 函数 打 断 ,你 可 以 在 你 的 自 定义 控件 中 重 载 虚 画 
数 Onlnternalldle, 并 调用 其 基 类 的 Onlnternalldle KA. ERAKAR TAE: 


void wxImageCtrl::OnInternalIdle() 
wxControl: :OnInternalIdle(); 
if (m_needResize) 


m_needResize = false; 
SizeContent(); 


} 
void wxImageCtr1: :OnSize(wxSizeEvent& event) 


m_needResize = true; 


有 时 候 你 可 能 想 强制 执行 系统 空闲 处 理 函 数 ,即使 没有 任何 事件 导致 系统 空闲 事件 被 再 次 调用 . 
你 可 以 通过 wxWakeUpldle 本 数 强制 启动 空闲 事件 处 理 .另外 一 个 方法 是 启动 一 个 不 做 任何 事情 
的 定时 器 ,由 于 定时 器 会 定时 送出 定时 器 事件 ,因此 在 定时 器 事件 处 理 完 以 后 (实际 上 什么 事 也 没 
做 ), 就 会 周期 性 的 引发 系统 空闲 事件 处 理 ,要 强制 立即 外 理 所 有 的 空闲 事件 ,你 可 以 直接 调用 
wxApp::Processldle 函 数 ,但 是 依 平 台 的 不 同 ,这 可 能 会 影响 到 内 部 空 朵 事件 处 理 (比如 在 
GTK+ 平 台 上 ,窗口 重 绘 都 是 在 空间 时 间 完 成 的 ). 


使 用 空闲 事件 进行 用 户 界面 更 新 的 内 容 ,我 们 已 经 在 第 9 章 ," 创 建 定制 的 对 话 框 "中 介绍 过 , 它 用 
来 另外 一 种 形式 的 系统 空闲 事件 wxUpdateUlEvent. 


强制 处 理 用 户 界 面 更 新 事件 


当 一 个 应 用 程序 忙于 处 理 一 个 很 耗 时 的 工作 的 时 候 , 它 可 能 来 不 及 更 新 用 户 界面 ,这 时 候 用 户 界 
面 就 好 像 被 冻结 一 样 ,要 避免 这 种 情况 ,你 可 以 在 那个 耗 时 的 任务 中 周期 性 的 调用 wxApp::Yield 
函数 (或 者 它 的 等 价 体 wxYield). 不 过 这 种 方法 应 该 尽量 少 的 使 用 ,因为 它 可 能 会 导致 不 可 知 的 问 
题 .比如 ,Yield 可 能 会 导致 处 理 用 户 命令 事件 ,这 个 事件 可 能 会 导致 特定 的 任务 被 重新 执行 ,尽管 
我 们 目前 仍 在 执行 这 个 任务 .我 们 称 之 为 重 入 .函数 wxSafeYield 会 首先 禁用 所 有 的 窗口 ,然后 
Yield, 然 后 再 重新 使 能 所 有 的 窗口 以 尽 可 能 避免 重 入 .如 果 你 给 wxApp::Yield 函 数 传递 True 作为 
参数 ,那么 如 果 正 在 进行 Yield, 第 二 次 的 Yield 动 作 将 放弃 ,这 也 是 另外 一 种 降低 重 入 风险 的 办 法 . 


如 果 你 希望 周期 的 更 新 特定 显示 ,直接 调用 wxWindow::Update 画 数 会 比较 好 ,因为 这 将 只 会 导 
致 未 义理 的 重 绘 事件 被 义理 . 


第 十 七 章 小 结 


正如 给 一 个 银行 业务 员 的 业务 窗口 从 一 个 变 成 两 个 不 大 会 提高 他 每 小 时 接待 的 顾客 数目 一 样 
多 线程 并 不 会 让 你 的 程序 运行 的 更 快 (至 少 在 普通 的 硬件 环境 下 是 这 样 ). 然 而 , 它 可 以 让 你 的 程 
序 看 上 去 比 不 用 线程 更 流畅 了 ,正如 那个 业务 员 在 一 个 柜台 等 刷卡 的 时 候 可 以 跑 到 另外 一 个 窗 
口 继续 办 公 一 样 ,多 线程 可 以 让 你 的 系统 的 资源 使 用 的 更 有 效率 .在 解决 某 些 特定 的 问题 方面 , 它 
也 比 不 用 多 线程 的 手段 看 上 去 更 优雅 .在 这 一 章 的 最 后 ,我 们 还 介绍 了 多 线程 蔡 代 方案 相关 的 内 
容 ,包括 空闲 事件 处 理 ,定时 器 和 Yield 等 . 


关于 多 线程 编程 还 有 很 多 方面 的 问题 这 里 没有 涉及 到 ,如 果 你 对 更 深入 的 内 容 感 兴趣 ,推荐 你 阅 
读 David R. Butenhof 写 的 书 "Programming with POSIX Threads". 


下 一 章 我 们 来 看 看 怎样 使 用 socket 编 程 以 便 在 进程 间 传 递 数据 . 


第 十 八 章 使 用 wxSocket 编 程 
socket 是 一 个 数据 传输 的 管道 .socket 并 不 关心 它 正在 传输 什么 类 型 的 数据 ,也 不 关心 数据 从 和 


录 你 的 即时 消息 帐号 等 等 时 候 , 你 在 都 使 用 着 socket.socket 可 以 被 用 来 再 任何 支持 socket 的 设 
各 之 间 建 立 连 接 ,包括 连接 一 台电 脑 和 一 台电 冰箱 (只 要 它 支持 socket). 


Socket 编 程 的 API 最 初 是 BSD unix 系 统 的 一 部 分 ,因为 其 起 源 的 单一 性 ,这 个 API 变 成 了 一 种 标 
准 .所 有 现代 的 操作 系统 都 会 实现 一 个 socket 层 ,来 提供 按照 TCP 或 者 UDP 协议 通过 网 络 (比如 
际 互联 网 ) 向 外 发 送 数据 .使 用 wxWidgets 提 供 的 wxSocket, 你 可 以 安全 的 从 一 台电 脑 向 另外 一 
台电 脑 发 送 任何 数量 的 数据 .本 章 也 将 涉及 一 些 socket 技 术 的 基础 知识 ,但 是 socket 操 作 本 身 是 
非常 简单 明了 的 . 


虽然 基本 的 socket 操 作 是 非常 简单 的 ,在 Windows,Linux 和 Mac OSX 平 台 上 也 是 非常 类 似 的 ,但 
是 每 个 平台 在 实现 socket 的 时 候 还 是 有 一 些 细微 的 差别 ,必须 针对 某 个 特定 的 平台 作 一 些 适 配 . 
基于 事件 的 socket 操 作 在 各 个 平台 上 的 差异 就 更 为 突出 ,这 使 得 在 各 个 平台 上 使 用 这 种 机 制 都 
成 为 一 个 挑战 .而 wxWidgets 则 使 用 wxSocket 类 屏 敬 了 这 些 差别 ,从 而 使 得 制作 基于 事件 的 跨 平 
台 的 socket 程 序 变 得 相对 容易 . 


另外 需要 注意 的 是 ,到 作者 停 笔 前 为 止 ,wxWidgets 还 不 支持 UDP 协 议 的 数据 收发 ,也 许 在 将 来 的 
版 本 中 会 增加 UDP 的 支持 . 


18.1 Socket 类 和 功能 概览 


socket 操 作 的 核心 类 是 wxSocketBase, 它 提供 了 类 似 发 送 和 接收 数据 ,关闭 连接 ,错误 报告 等 这 
样 的 功能 .创建 一 个 监听 socket 或 者 连接 到 一 个 socket 服 务 器 ,你 需要 分 别 使 用 wxSocketServer 
和 wxSocketClient.wxSocketEvent 用 来 通知 应 用 程序 socket 上 有 事件 发 生 . 虚 类 
WwWXxSocketBase 和 它 的 一 些 子 类 比如 wxIPV4address 让 你 可 以 指定 特定 的 远 端 地 址 和 端口 .最 
后 , wxSocketlnputStream 和 wxSocketOutputStream 等 这 些 流 对 象 让 你 以 流 的 方式 处 理 socket 
上 的 数据 移动 和 传输 .关于 流 操 作 的 更 多 内 容 参 见 第 14 章 ," 文 件 和 流 操作 " 


正如 我 们 在 稍 后 的 "Socket 标 记 " 小 节 中 即将 讨论 的 那样 ,socket 可 以 以 不 同 的 方式 使 用 .传统 的 
使 用 线程 的 操作 方式 将 禁止 socket 事 件 的 产生 和 发 送 ,而 在 线程 中 以 阻塞 的 方式 进行 socket 的 
操作 .而 另 一 方面 ,你 也 可 能 使 用 基于 事件 的 方式 以 便 逃 避 使 用 线程 的 复杂 性 . wxWdigets 将 在 
需要 的 时 候 通 过 事件 通知 你 需要 对 某 个 socket 进 行 操 作 了 .通过 这 种 方式 ,数据 的 接收 是 放 在 后 
台 的 ,你 仅 需要 在 有 数据 到 来 的 时 候 处 理 它 , 它 将 不 会 阻塞 你 的 GUI 界 面 ,也 没有 基于 每 个 线程 一 
个 socket 的 实现 的 那 种 复杂 性 . 


本 章 我 们 通过 一 个 完整 的 例子 来 介绍 wxSocket 的 这 两 种 使 用 方法 以 及 使 用 到 的 那些 wxSocket 
类 的 APl. 虽 然 仅 仅 是 一 个 例子 ,但 是 例子 中 的 代码 都 可 以 作为 正式 的 代码 来 使 用 . 


18.2 Socket 及 其 基本 处理 介绍 


TET E T R E TE gt Wi se 
的 介绍 .代码 是 相当 直观 的 ,只 需要 你 有 一 点 最 基础 的 socket 编 程 的 背景 .为 了 简洁 起 见 ,所 有 GUI 
操作 的 部 分 将 被 省 略 我 们 只 4 关注 那些 Socket 有 关 的 范 数 .完整 的 代码 可 以 在 光盘 的 
examples/chap18 目 录 中 找到 .例子 中 用 到 的 socket API 都 附 有 详细 的 使 用 手册 . 


这 个 例子 程序 的 功能 是 很 简单 的 ,服务 器 倾听 连接 请 求 , 当 有 客户 端 建立 连接 的 时 候 ,服务 器 首先 


从 socket 上 接收 10 个 字符 ,然后 再 把 这 10 个 字符 发 送 回 去 .相应 的 ,客户 端 在 建立 连接 以 后 先 发 
送 10 个 字符 ,然后 等 待 接收 10 个 响应 字符 .在 例子 中 ,这 10 个 字符 写 死 为 "0123456789". 服 务 器 
端 和 客户 端的 程序 运行 的 样子 如 下 图 所 示 : 

jim “Socket Event Demo: Server lel 

File 


Welcome to the Socket Event Demo: Server 
You need to Start the server! 


Socket server listening. 


Accepted incoming connection. 


Received from client: 0123456789 
Wrote string back to client. 





jm Socket Event Demo: Client -10l 
File Client 

welcome to the Socket Event Demo: Client 

Client ready 


Connected to server. 
Wrote string to server. 
Received from server: 0123456789 


Connection lost. 





客户 端的 代码 
下 面 列 出 了 客户 端的 关键 代码 


BEGIN_EVENT_TABLE(MyFrame, wxFrame) 
EVT_MENU(CLIENT_CONNECT, MyFrame: :OnConnectToServer ) 
EVT_SOCKET(SOCKET_ID, MyFrame: :OnSocketEvent ) 
END_EVENT_TABLE( ) 
void MyFrame: :OnConnectToServer (wxCommandEvent& WXUNUSED(event ) ) 
{ 

wxIPV4address addr; 

addr .Hostname(wxT("localhost")); 

addr .Service(3000) ; 

// 创建 Socket 

wxSocketClient* Socket = new wxSocketClient(); 

// 设置 要 监视 的 Socket 事 件 

Socket ->SetEventHandler(*this, SOCKET_ID); 

Socket ->SetNotify(wxSOCKET_CONNECTION_FLAG | 
wxSOCKET_INPUT_FLAG | 
wxSOCKET_LOST_FLAG); 

Socket ->Notify(true); 

// 等 待 连接 事件 


Socket->Connect(addr, false); 


void MyFrame: :OnSocketEvent (wxSocketEvent& event) 
{ 
// 从 事件 获取 socket 
wxSocketBase* sock = event.GetSocket(); 
// 所 有 事件 共享 的 一 块 缓冲 (Common buffer shared by the events) 
char buf[10]; 
switch(event.GetSocketEvent()) 


{ 

case wxSOCKET_CONNECTION: 

{ 
// 填充 '0' - "9 ' 的 ASCII 码 
char mychar = '0'; 
for (int i = 0; i &lt; 10; i++) 

buf[i] = mychar++; 

} 
// 发 送 10 个 字符 到 对 端 
sock->write(buf, sizeof(buf)); 
break; 

case wxSOCKET_INPUT: 

{ 
sock->Read(buf, sizeof(buf)); 
break; 

} 

// 服务 器 在 发 送 10 个 字 节 以 后 关闭 了 连接 

case wxSOCKET_LOST: 

{ 
sock->Destroy(); 
break; 

} 

} 
} 
服务 器 端 代码 


下 面 列 出 了 服务 器 端的 代码 


BEGIN_EVENT_TABLE(MyFrame, wxFrame) 
EVT_MENU(SERVER_START, MyFrame::OnServerStart ) 
EVT_SOCKET(SERVER_ID, MyFrame::OnServerEvent ) 
EVT_SOCKET(SOCKET_ID, MyFrame::OnSocketEvent ) 

END_EVENT_TABLE( ) 

void MyFrame: :OnServerStart(wxCommandEvent& WXUNUSED(event) ) 

{ 

// 创建 地 址 , 默认 为 localhost:0 

wxIPV4address addr; 

addr .Service(3000) ; 

// 创建 一 个 Socket, 保留 其 地 址 以 便 我 们 可 以 在 需要 的 时 候 关 闭 它 
m_server = new wxSocketServer(addr); 

// 检查 Ok 函数 以 判断 服务 器 是 否 正常 启动 

if (! m_server->0k()) 

{ 


return; 


} 

// 设置 我 们 需要 监视 的 事件 

m_server ->SetEventHandler(*this, SERVER_ID); 
m_server ->SetNotify(wxSOCKET_CONNECTION_FLAG) ; 
m_server ->Notify(true); 


void MyFrame: :OnServerEvent (wxSocketEvent& WXUNUSED(event ) ) 

{ 
// 接受 连接 请 求 , 并 创建 Socket 
wxSocketBase* sock = m_server->Accept(false); 
// 告诉 这 个 新 的 Socket 它 的 事件 应 该 被 谁 处 理 
sock->SetEventHandler(*this, SOCKET_ID); 
sock->SetNotify(wxSOCKET_INPUT_FLAG | wxSOCKET_LOST_FLAG); 
sock->Notify(true); 


void MyFrame: :OnSocketEvent (wxSocketEvent& event) 


{ 
wxSocketBase *sock = event.GetSocket(); 
// 处 理事 件 
switch(event.GetSocketEvent()) 
{ 
case wxSOCKET_INPUT: 
{ 
char buf[10]; 
// 读数 据 
sock->Read(buf, sizeof(buf)); 
// 写 回 数据 
sock->write(buf, sizeof(buf)); 
// 服务 器 接受 的 这 个 socket 已 经 完成 任务 , 释放 它 
sock->Destroy(); 
break; 
case wxSOCKET_LOST: 
sock->Destroy(); 
break; 
} 
} 
} 
连接 服务 器 


这 一 小 段 我 们 来 解释 一 下 怎样 创建 一 个 客户 端 Socket 并 且 用 它 连 接 某 个 Server. 
Socket 地 址 


所 有 的 socket 地 址 相关 的 类 都 是 基于 虚 类 wxSockAddress, 它 提供 了 基于 socket 标 准 的 所 有 地 
址 相关 的 参数 和 操作 .而 wxIPV4address 类 则 具体 实现 了 当前 应 用 最 广泛 的 标准 国际 地 址 方案 
IPV4.wxIPV6address 类 是 用 来 提供 IPv6 支 持 的 ,不 过 它 的 功能 实现 的 并 不 完整 ,等 到 IPv6 在 全 


世界 范围 内 广泛 使 用 的 那天 ,这 个 类 当然 会 相应 的 变 得 完整 . 


注意 :如 果 地 址 使 用 的 是 一 个 长 整 型 ,那么 它 期 待 的 是 网 络 序 排列 方式 , 它 返 回 的 长 整 型 地 址 也 总 
是 网 络 序 排列 方式 .网 络 序 是 对 应 的 是 Big endian(lntel 和 AMD 的 x86 体 系 使 用 的 是 little endian, 
而 Apple 的 系统 使 用 的 是 big endian). 你 可 以 使 用 字 节 序 转换 宏 wxINT32_SWAP_ON_LE 来 进 
行 平台 无 关 的 字 节 续 转换 ,这 个 宏 只 在 使 用 little endian 的 平台 上 才 进 行 相应 的 转换 工作 .如 下 所 
个 \: 


IPV4addr .Hostname(wxINT32_SWAP_ON_LE(longAddress) ); 


Hostname 可 以 采用 的 参数 包括 一 个 wxString 类 型 的 字符 串 ( 比 如 www.widgets.org) 或 者 一 个 长 
整 型 的 IP 地址 (前 面 已 经 提 到 过 ,采用 big endian), 如 果 没 有 任何 参数 , 则 Hostname 返 回 当 前 主机 
的 主机 名 . 


Service 用 来 设置 远 端 端 口 ,你 可 以 指定 一 个 wxString 类 型 的 已 知 服务 名 或 者 直接 指定 一 个 short 
类 型 的 整数 .如 果 不 带 任何 参数 ,Service 返 回 当前 指定 的 远 端 端口 . 


IPAddress 画 数 返 回 一 个 十 进 制 的 以 点 分 割 的 wxString 类 型 的 远 端 ip 地 址 . 
AnyAddress 将 地 址 设置 为 本 机 的 任何 IP 地 址 ,相当 于 将 地 址 设置 为 INADDR_ANY 
Socket 客 户 端 


wxSocketClient 继 承 自 wxSocketBase 并 且 同 时 继承 了 所 有 的 通用 Socket 操 作画 数 . 新 增 的 少数 
几 个 画 数 主 要 用 来 发 起 和 建立 远 端 连接 . 


Connect 函 数 采用 一 个 wxSockAddress 参 数 以 便 知 道 要 连接 的 远 端 地 址 和 端口 .正如 前 面 提 到 
的 那样 ,你 应 该 使 用 类 似 wxIPV4address 这 样 的 地 址 而 不 能 直接 使 用 wxSockAddress. 第 二 个 参 
数 是 一 个 bool 类 型 ,默认 为 true, 指 示 是 否 应 该 等 连接 建立 再 返回 .如 果 这 个 函数 在 主线 程 中 运行 ， 
所 有 的 GUI 都 将 冻结 直至 这 个 函数 返回 . 


WaitOnConnect 用 来 在 Connect 被 以 false 作 为 第 二 个 参数 调用 以 后 (不 阻塞 ) 调 用 .第 一 个 参数 指 
示 要 等 待 的 秒 数 , 第 二 个 参数 则 用 来 指示 窜 秒 数 .无 论 连接 函数 成 功 还 是 失败 ,这 个 函数 都 将 返 
回 成 功 .只 有 当 连 接 本 数 返回 超时 的 时 候 , 这 个 函数 才 会 返回 失败 .如 果 第 一 个 参数 是 -1, 则 代表 
使 用 默认 的 超时 时 长 ,通常 是 10 分 钟 .也 可 以 使 用 SetTimeout 函 数 修改 默认 的 超时 时 长 . 


Socket 事 件 
所 有 的 Socket 事 件 都 是 使 用 同一 个 事件 映射 宕 EVT_SOCKET 指 定 的 . 


EVT_SOCKET(identifier, function) 宏 将 标识 符 为 jdentifier 的 事件 发 送 给 指定 的 函数 义理 . 义 理 
函数 的 参数 类 型 为 wxXSocketEvent. 


wxSocketEvent 事 件 非 常 简 单 ,内 部 存储 了 事件 的 标识 符 和 对 应 的 wxSocket 对 象 指针 ,这 可 以 避 
免 自己 保存 socket 指 针 的 麻烦 . 


Socket 事 件 类 型 


下 表 列 出 了 GetSocketEvent 画 数 可 能 返回 的 事件 类 型 . 


指示 socket 上 有 数据 可 以 接收 .无 论 是 socket 数 据 缓存 原 
wxSOCKET_INPUT 本 没有 数据 ,新 收 到 了 数据 ,还 是 说 原本 就 有 数据 ,只 是 用 户 
还 没有 读 完 ,都 将 产生 这 个 事件 . 


这 个 事件 通常 在 socket 的 Connect 函 数 第 一 次 连接 成 功 或 
者 说 Accept 刚 刚 接受 了 一 个 新 的 Socket 的 时 候 产 生 , 并 且 
peste reiki 通常 是 产生 在 socket 的 写 操作 失败 ,缓冲 区 的 数据 又 从 无 
到 有 的 时 候 . 
对 于 客户 端 来 说 ,用 来 只 是 Connect 动 作 已 经 成 功 了 ,对 于 
服务 端 来 说 ,指示 新 接受 了 一 个 Socket. 


用 来 指示 接收 数据 时 针对 socket 的 关闭 操作 .这 通常 意味 
wxSOCKET_LOST 着 对 端 已 经 关闭 了 socket. 这 个 事件 在 连接 失败 的 时 候 也 
有 可 能 产生 . 


wxSOCKET_CONNECTION 


wxSocketEventiJ = Æ ñ ER 

GetSocket 返 回 指 向 产生 这 个 事件 的 wxSocketBase 对 象 的 指针 . 
GetSocketEvent 返 回 对 应 的 上 表 列 出 的 事件 类 型 . 

使 用 Socket 事 件 


要 处 理 socket 事 件 ,你 需要 首先 指定 一 个 事件 处 理 器 并 且 指 定 你 想 要 处 理 的 事件 类 

型 .wxSocketBase 支 持 的 各 种 事件 宏 , 你 可 以 在 上 面 的 服务 器 端 例子 中 监听 socket 创 建 以 后 的 
代码 中 看 到 .需要 注意 的 事 ,对 Socket 事 件 的 设置 仅 对 当前 的 socket 起 作用 ,如 果 你 希望 监听 别 的 
socket 的 相关 事件 ,你 需要 对 那个 socket 再 次 设置 监听 事件 . 


SetEventHandler 函 数 将 某 个 事件 标识 符 和 相应 的 事件 处 理 器 关联 起 来 . 事件 标识 符 必须 和 事 
件 处 理 器 对 应 的 事件 表 中 指定 的 标识 符 相 对 应 . 

SetNotify 用 来 设置 想 要 监听 的 事件 , 它 的 参数 是 一 个 bit 为 列表 ,比如 wxSOCKET_INPUT_FLAG 
| wxSOCKET_LOST_FLAG 将 监听 有 数据 到 来 以 及 socket 被 关闭 事件 . 


Notify 使 用 一 个 bool 类 型 的 参数 ,来 指示 你 是 否 想 或 者 不 想 收 到 当前 指定 的 事件 . 它 的 作用 是 让 
你 在 SetNotify 之 后 可 以 不 带 事件 指示 来 打开 或 者 关闭 事件 监听 . 

Socket 状 态 和 错误 提醒 

在 讨论 数据 发 送 和 接收 之 前 ,我 们 先 来 描述 一 下 socket 状 态 和 socket 的 错误 提醒 ,以 便 我 们 在 讨 
论 数据 接收 的 时 候 可 以 引用 他 们 . 

Close 画 数 关 闭 socket, 禁 止 随后 的 任何 数据 传输 并 且 会 通知 对 端 socket 已 经 被 关闭 .注意 可 能 在 


关闭 之 前 已 经 缓存 了 一 些 socket 事 件 , 因 此 在 socket 被 关闭 之 后 你 可 能 还 要 准备 好 处 理 可 能 缓 
存 的 socket 事 件 . 


Destroy 画 数 应 该 代替 针对 socket 的 delete 操 作 , 原 因 和 Window 对 象 类 似 ,有 可 能 队列 中 仍然 有 
针对 这 个 socket 的 事件 ,因此 ,在 系统 事件 队列 处 理 完 以 后 再 释放 这 个 socket 是 一 个 安全 的 作 
法 ,Destroy 画 数 正 是 提供 了 这 个 功能 


Error 函 数 返 回 True 如 果 上 次 的 socket 操 作 遇 到 某 种 错误 . 
GetPeer 返 回 一 个 wxSockAddress 引 用 , 它 包含 当前 socket 的 对 端 信息 比如 IP 地 址 和 端口 号 . 
IsConnected 返 回 是 否 这 个 socket 已 经 成 功 连接 . 


LastCount 返 回 最 近 一 次 读 写 操作 成 功 进行 的 字 节 数 . 


LastError 返 回 最 近 一 次 的 错误 码 . 注 意 如 果 操 作成 功 并 不 会 更 新 最 近 一 次 的 错误 码 ,因此 你 需要 
a 次 操作 是 否 成 功 .socket 所 支持 的 错误 码 如 下 表 所 示 : 
wxSOCKET_INVOP 非法 操作 ,比如 使 用 了 非法 的 地 址 类 型 . 
wxSOCKET_IOERR IO 错误 ,比如 无 法 创建 和 初始 化 socket. 
wxSOCKET_INVADDR 不 正确 的 地 址 , 比如 试图 连接 空地 址 或 者 不 完整 的 地 址 . 
wxSOCKET_INVSOCK socket 使 用 方法 不 正确 或 者 尚未 初始 化 . 
wxSOCKET_NOHOST 指定 的 地 址 不 存在 . 
wxSOCKET_INVPORT 无 效 端口 . 
wxSOCKET_WOULDBLOCK ae oe daar era ( 参 
wxSOCKET_TIMEDOUT socket 操 作 超 时 . 
wxSOCKET_MEMERR socket 操 作 时 内 存 分 配 失败 . 


Ok 返回 True 的 条 件 是 : 客户 端 Socket 必 须 已 经 和 Server 建 立 连 接 或 者 服务 端 Socket 已 经 成 功 绑 
定 了 本 地 地 址 并 且 开 始 监听 客户 端 连 接 


SetTimeout 指 定 阻塞 式 访问 的 超时 时 长 .默认 为 10 分 钟 . 
发 送 和 接收 Socket 数 据 


WwWxSocketBase 提 供 了 各 种 基本 的 或 高 级 的 读 写 socket 操 作 . 所 有 操作 都 将 保存 相关 的 数据 并 且 
支持 使 用 LastCount 返 回 成 功 操作 的 字 节 个 数 ,LastError 返 回 最 近 一 次 遇 到 的 操作 错误 码 . 


接收 
Discard 本 数 删除 所 有 的 socket 接 收 缓冲 区 数据 . 


Peek 函 数 让 你 可 以 读 取 缓冲 区 的 数据 但 是 不 将 socket 绥 冲 区 清除 .你 必须 指定 要 Peek 的 数据 的 
大 小 并 且 自 己 提 供 Peek 目 的 地 的 缓冲 区 . 


Read 男 数 和 Peek 一 样 ,只 是 它 在 成 功 获取 数据 以 后 会 清除 相应 的 Socket 接 收 缓冲 区 . 


ReadMsg 本 数 对 应 于 WriteMsg 画 数 ,将 会 完整 的 接收 WriteMsg 发 送 的 数据 ,除非 需要 系统 错误 . 
注意 如 果 ReadMsg 开 辟 的 缓冲 区 比 WriteMsg 发 送 的 数据 少 , 则 多 出 的 数据 和 将 被 直接 删除 . 


Unread 特 数据 放 回 接收 缓冲 区 ,你 需要 指定 希望 放 回 去 的 数据 的 字 节 数 . 
Write 画 数 以 参数 中 数据 指针 指向 的 缓冲 作为 开始 位 置 ,向 socket 写 人 参数 中 指定 的 数据 大 小 . 


WriteMsg 和 Write 的 区 别 在 于 ,wxWidgets 会 增加 一 个 消息 头 ,以 便 接收 端 可 以 准确 的 知道 消息 的 
大 小 ,WriteMsg 发 送 的 数据 必须 由 ReadMsg 男 数 接收 . 


创建 一 个 Server 


WXSocketServer 也 只 对 其 基 类 wxSocketBase 增 加 了 少数 几 个 函数 用 来 创建 和 监听 连接 请 求 . 
要 创建 一 个 Servenr, 你 必须 指定 要 监听 的 端口 .wxSocketServer 使 用 和 wxSocketClient 一 样 的 
wxlIPV4address 类 型 ,只 是 前 者 不 需要 指定 远 端 地 址 .在 大 多 数 情况 下 ,你 需要 调用 Ok 范 数 来 阐 
煌 是 否 绑 定 和 监听 动作 已 经 成 功 . 


wxXxSocketServer 的 主要 成 员 画 数 


wxXSocketServer 构 造 画 数 使 用 一 个 地 址 对 象 用 来 指定 监听 端口 ,以 及 一 个 可 选 的 Socket 标 记 ( 参 
见 下 一 节 "Socket Flags"). 


Accept 函 数 返 回 一 个 新 的 socket 连 接 或 者 立即 返回 NULL, 如 果 没 有 连接 请 求 .你 可 以 设置 可 选 
的 等 待 标记 ,如 果 你 这 样 做 ,Accept 将 导致 程序 阻塞 . 


AcceptWith 和 Accept 的 功能 相近 ,只 是 它 提供 一 个 额外 的 已 存在 的 wxSocketBase 对 象 (引用 ), 并 
且 其 返回 值 为 bool 型 ,用 来 指示 是 否 接受 了 一 个 新 的 连接 . 


WaitForAccept 采 用 一 个 秒 参数 和 一 个 毫秒 参数 以 指定 在 某 个 事件 范围 内 等 待 新 的 连接 请 求 , 如 
果 请 求 发 生 则 返回 True, 否 则 超时 返回 False. 


处 理 新 的 连接 请 求 事件 


当 监 听 socket 检 测 到 一 个 新 的 连接 请 求 的 时 候 , 将 产生 一 个 相应 的 事件 .在 其 事件 处 理 函 数 中 ,你 
可 以 接受 这 个 请 求 并 且 执 行 任何 必要 的 即时 处 理 .你 需要 保证 连接 在 其 生命 周期 内 不 被 立即 关 
闭 ,你 还 需要 为 新 接受 的 socket 指 定 事件 处 理 器 .注意 监听 的 socket 在 被 关闭 之 前 将 一 直 在 监听 ， 
而 每 一 个 新 的 连接 请 求 都 会 创建 一 个 新 的 socket. 在 server 的 整个 生命 周期 内 ,同一 个 监听 
socket 可 以 接受 成 千 上 万 个 新 的 socket. 


Socket 事 件 概述 


从 程序 员 的 观点 来 说 ,基于 事件 的 socket 义理 简化 了 socket 编 程 ,使 得 他 们 不 需要 关心 线程 的 创 
建 和 释放 .这 个 例子 没有 使 用 线程 , 但 是 GUI 界面 同样 不 会 阻塞 ,因为 所 有 的 数据 读 取 都 是 在 确信 
有 数据 到 来 的 时 候 才 进行 的 ,因此 会 立即 返回 .如 果 有 很 大 量 的 数据 需要 读 取 , 你 可 以 将 它们 分 为 


多 个 小 部 分 ,然后 一 次 读 一 部 分 并 将 其 放 和 人 你 自己 的 缓冲 区 .或 者 你 可 以 使 用 Peek 郴 数 检 查 当 前 
缓冲 区 的 数据 的 数量 ,如 果 没 有 达到 需要 处 理 的 范围 ,你 可 以 什么 也 不 做 , 静 静 等 待 下 一 次 数据 事 
件 通知 的 到 来 . 


在 下 一 节 , 我 们 来 看 看 怎样 使 用 不 同 的 socket 标 记 来 改变 socket 的 行为 . 


18.3 Socket 标 记 


Socket 的 行为 可 能 随 着 创建 时 指定 的 不 同 而 有 很 大 的 差异 ,下 表 列 出 了 Socket 可 以 指定 的 标记 : 


wxSOCKET_NONE 普通 行为 (行为 和 底层 的 send 和 recv 落 数 一 致 ). 
wxSOCKET_NOWAIT 读 和 写 操 作 尽 可 能 快速 的 返回 . 
wxSOCKET_WAITALL 等 待 所 有 的 读 写 数据 完成 操作 ,除非 出 现 系统 错误 . 
wxSOCKET_BLOCK 在 读 写 数据 的 时 候 阻 塞 GUI 界 面 . 


如 果 没 有 指定 任何 标记 (或 者 指定 了 wxSOCKET_NONE 标 记 ),I/O 操 作 将 在 部 分 数据 被 读 写 的 
时 候 返 回 ,甚至 在 整个 数据 还 没有 传输 完 的 情况 下 也 是 这 样 .这 和 使 用 阻塞 方式 调用 底层 的 recv 
或 者 send 画 数 的 效果 是 一 样 的 .注意 这 里 所 说 的 阻塞 指 的 是 画 数 被 阻止 返回 ,并 不 意味 着 图 形 用 
户 界面 被 冻结 . 


如 果 指 定 了 wxSOCKET_NOWAIT 标 记 ,J/O 将 立刻 返回 .对 于 读 操 作 , 它 将 读 取 所 有 当前 输入 缓 
冲 区 拥有 的 数据 后 立刻 返回 ,对 于 写 操 作 , 它 将 尽 可 能 多 的 发 送 数据 以 后 立刻 返回 ,这 取决 于 当前 
的 输出 缓冲 区 的 大 小 ,这 种 方式 等 同 于 使 用 非 阻塞 方 式 调用 底层 函数 recv 或 send. 同 样 , 这 里 的 
阻塞 也 指 的 是 函数 返回 ,而 不 是 用 户 界 面 阻塞 . 


如 果 指 定 了 wxSOCKET_WAITALL 标 记 ,l/O 操 作 将 在 所 有 要 求 的 数据 被 读 取 或 者 被 写 入 以 后 
(或 者 发 生 系统 错误 ) 才 会 返回 . 如 果 需 要 的 话 ,将 以 阻塞 的 方式 调度 底层 系统 函数 .这 相当 于 使 用 
一 个 循环 重复 以 阻塞 的 方式 调用 recv 或 者 send 画 数 以 便 传 输 所 有 的 数据 . 同 祥 ,这 里 的 阻塞 也 指 
的 是 阻塞 底层 本 数 而 不 是 GUI. 注 意 ReadMsg 和 WriteMsg 画 数 将 隐 式 使 用 这 种 方式 ,并 且 忽 略 你 
可 能 设置 的 wxSOCKET_NONE 或 wxSOCKET_NOWAIT 标 记 . 


用 来 指示 wxSOCKET_BLOCK 是 否 在 IO 操作 的 间隙 执行 Yield 操 作 ( 译 者 注 : 参 见 前 面 关 于 线程 
的 替代 方案 中 的 描述 ), 如 果 指 定 了 这 个 标记 ,socket 在 底层 操作 间隙 将 不 会 执行 Yield 动 作 , 反 之 ， 
如 果 没 有 指定 这 个 标记 ,那么 你 要 非常 小 心 这 可 能 产生 的 代码 重 入 的 问题 . 


总 的 来 说 : 


e wxSOCKET_NONE 总 是 试图 读 取 或 者 宇 入 一 些 数据 ,但 是 不 关心 具体 是 多 少数 据 . 

e wxSOCKET_NOWAIT 只 关心 尽快 返回 ,即使 没有 读 取 或 写 任 何 数据 . 

e wxSOCKET_WAITALL 将 在 所 有 的 数据 都 被 宇 入 或 者 是 读 取 的 数据 达到 要 求 的 数目 的 时 
候 返 回 . 

wxSOCKET_BLOCK 和 前 面 的 标记 没有 关系 ,只 控制 否则 在 底层 操作 的 间隙 执行 Yield 动 
VE. 


wxWidget 中 的 阻塞 和 非 阻塞 socket 


在 wxWidgets 中 的 阻塞 方式 有 双重 的 含义 .在 一 般 的 编程 中 ,socket 阻 塞 意 味 着 当前 的 线程 被 挂 
起 直至 socket 操 作 超时 或 者 数据 操作 完成 .如 果 是 主线 程 阻塞 , 则 用 于 界面 也 相应 阻塞 . 


而 在 wxWidgets 中 ,有 两 种 类 型 的 阻塞 ;socket 阻塞 和 用 户 界 面 阻 塞 .wxSOCKET_BLOCK 标 记 指 
示 在 socket 阻 塞 的 时 候 , 是 否 同时 阻塞 用 户 界 面 .你 也 许 回 问 , 这 怎么 可 能 呢 , 怎 么 可 能 作 到 阻塞 
了 socket 操 作 而 不 阻塞 用 户 界面 呢 ? 这 主要 是 因为 在 socket 被 阻塞 的 时 候 ,wxWidgets 还 可 以 处 
理 所 有 的 事件 ,因为 socket 的 底层 函数 义理 的 间 隐 调用 了 wxYield, 这 个 函数 可 以 义理 队列 中 所 有 
未 处 理 的 事件 ,包括 用 户 界面 相关 的 事件 .虽然 在 socket 操 作 未 结束 之 前 ,代码 一 直 在 socket 函 数 
中 运转 ,但 是 所 有 事件 还 是 可 以 被 有 序 的 处 理 . 


对 于 刚 开 始 使 用 wxWidgets 的 人 来 说 , 听 上 去 这 是 一 个 很 美妙 的 事情 .如 果 你 是 第 一 次 使 用 
WwWXxWidgets 进 行 socket 编 程 ,你 可 能 会 觉得 ,再 也 不 需要 使 用 任何 单独 的 线程 来 处 理 socket 了 ,你 
可 以 将 socket 设 置 为 wxXSOCKET WAITALL 和 wxSOCKET_BLOCK, 这 样 你 可 以 通过 事件 机 制 
处 理 socket 数 据 ,而 GUI 也 不 会 被 阻塞 ,不 幸 的 是 ,我 必须 先 警 告 你 ,这 种 想法 可 能 是 你 痛苦 的 开 
始 . 


让 我 们 来 假设 一 个 服务 端 有 两 个 活动 连接 ,每 一 个 都 设置 了 wxSOCKET_WAITALL 标 记 .更 进 一 
步 ,我 们 假设 其 中 一 个 连接 正在 以 一 种 很 缓慢 的 速度 传输 一 个 很 大 量 的 数据 .Socket 1 的 读 缓 冲 
区 没有 数据 了 ,因此 它 调用 了 wxYield, 而 Socket2 还 有 未 处 理 的 事件 在 队列 里 ,这 时 候 会 发 生 的 事 
情 是 :Socket1 调 用 的 wxYield 试 图 处 理 Socket2 相 关 的 消息 ,但 是 因为 Socket2 的 连接 很 缓慢 , 它 
的 事件 总 是 结束 不 了 , 它 也 会 调用 wxYield 来 避免 GUI 阻塞 ,这 将 导致 出 现 一 个 名 声 不 太 好 的 告警 
消息 "wxYield called recursively"(wxYield 被 递归 调用 ), 在 Socket2 的 数据 传输 结束 之 前 ,应 用 程 
序 的 堆栈 将 最 终 被 wxYield 的 递归 调用 给 耗 尽 , 因为 北 为 调用 使 用 这 些 堆栈 一 直 没 有 机 会 释放 ， 
于 是 人 们 开始 联系 wxWidgets 社 区 ,报告 发 现 了 一 个 bug, 而 实际 上 ,这 应 该 是 应 用 程序 自己 的 问 
题 而 不 是 wxWidgets 的 问题 .应 用 程序 不 应 该 以 这 种 方式 来 编程 , 它 应 该 避免 这 种 情形 出 现 , 因 

此 ,恐怕 wxWidgets 永 远 没有 办 法 改正 这 个 问题 . 


另外 一 方面 ,性 能 也 是 一 个 问题 ,为 了 不 阻止 GUI, 你 的 应 用 程序 将 不 得 不 浪费 CPU 的 资源 .试想 
一 下 ,用 户 界 面 要 立即 响应 , Socket 也 要 不 停 的 监视 是 否 有 数据 到 来 以 便 产 生 事件 通知 应 用 程 
序 , 要 让 两 者 都 得 到 满足 ,wxWidgets 所 能 做 的 唯一 的 办 法 就 是 使 用 循环 ,不 停 的 以 非 阻塞 的 方式 
去 用 系统 操作 select 去 测试 Socket, 然 后 再 调用 wxYield 人 处理 GU| 事 件 . 


不 可 用 的 标记 组 合 


容 我 再 罗 味 一 句 , 不 要 天 真 到 认为 WwxWidgets 采 用 了 一 种 神奇 的 Socket 处 理 机 制 .无 论 这 些 
Socket 的 标记 在 你 的 第 一 印象 中 看 起 来 是 多 么 的 诱 人 ,你 都 不 可 能 同时 满足 下 面 的 这 些 要 求 : 


e wxSOCKET_WAITALL 
。 不 阻塞 GUI 

e 少 于 100% 的 CPU 占 用 率 
。 单线 程 


你 可 以 指定 wxSOCKET_WAITALL 并 且 也 不 阻塞 GUI1, 但 是 这 将 导致 100% 的 CPU 占用 率 .如 果 
你 愿意 付出 阻塞 GUI 作为 代价 (指定 wxSOCKET_BLOCK 标 记 ), 你 将 可 以 得 到 
wxSOCKET_WAITALL 和 0% 的 CPU 占用 率 . 或 者 你 可 以 使 用 多 线程 来 实现 同时 使 用 
wxSOCKET_WAITALL 又 不 阻塞 GUIl, 并 且 也 不 用 100% 的 CPU 占用 率 .你 也 可 以 不 用 


wxSOCKET_WAITALL 而 使 用 wxSOCKET_NOWAIT 以 便 可 以 既 不 占用 100% 的 CPU 又 不 墙 塞 
GUI. 总 之 一 句 话 ,上 面 的 四 个 条 件 , 你 总 可 以 同时 满足 任意 三 个 ,但 是 你 不 可 以 四 个 条 件 同时 满 
足 . 


这 些 标记 是 怎样 影响 Socket 的 行为 的 


wxSOCKET_NONE, wxSOCKET_NOWAIT 和 wxSOCKET_WAITALL 是 互 斥 的 ,你 不 可 以 同时 
使 用 他 们 中 间 的 任何 两 个 ,而 wxSOCKET_BLOCK 和 wxSOCKET_NOWAIT 的 组 合 也 是 没有 意 
义 的 (如 果 任 何 本 数 都 立即 返回 ,怎么 可 能 阻塞 GUI 呢 ?), 因此 下 面 五 种 标记 的 组 合 是 有 意义 的 : 


。 wxSOCKET_NONE | wxSOCKET_BLOCK: 这 种 组 合 和 标准 的 socket 调 用 (recv 和 send) 
的 行为 相同 . 

wxSOCKET_NOWAIT: 和 标准 的 非 阻 塞 的 socket 调 用 行为 相同 . 

wxSOCKET_WAITALL | wxSOCKET_BLOCK: 和 普通 的 阻塞 式 socket 调 用 的 行为 相同 ,只 
不 过 recv 和 send 画 数 将 被 连续 多 次 调用 以 便 接 受 或 者 发 送 完整 的 数据 . 
wxSOCKET_NONE: 和 标准 的 socket 调 用 行为 相同 ,只 是 由 于 在 完成 系统 调用 之 前 (比如 数 
据 完 整 接 收 缓冲 区 数据 之 前 ) 调 用 了 wxYield, 因 此 看 上 去 GUI 并 不 会 阻塞 . 
wxSOCKET_WAITALL: 和 wxSOCKET_WAITALL | wxSOCKET_BLOCK 的 行为 相同 只 不 
过 GUI 将 不 被 阻塞 . 


只 有 最 后 两 种 情况 可 能 出 现 前 面 介绍 的 WxYield 函 数 重 入 的 问题 ,不 过 这 俩 组 标记 也 是 在 
wxWidgets 中 基于 事件 的 socket 编 程 中 最 主要 的 两 种 方式 (因为 他 们 阻塞 了 socket 但 是 却 不 阻 
塞 GUI). 使 用 这 两 组 标记 的 时 候 要 非常 小 心 避 免 这 个 问题 ,虽然 它们 很 强大 ,很 有 用 , 却 也 往往 是 
错误 和 麻烦 的 根源 ,因为 它们 太 容 易 被 误解 了 . 


标准 socket 和 wxSocket 


使 用 wxSOCKET_NONE | wxSOCKET_BLOCK 或 wxSOCKET_NOWAIT 的 时 候 和 直接 使 用 
socket 系 统 调用 的 效果 并 没有 不 同 ,唯一 的 不 同 是 你 使 用 的 是 wxWidgets 提 供 的 API 而 不 是 标准 
C 的 API. 不 过 ,即使 这 样 ,还 是 有 足够 的 理由 要 使 用 wxSocket, 这 些 理由 包括 :wxSocket 提 供 了 一 
个 面向 对 象 的 接口 ,隐藏 了 很 多 平台 相关 的 初始 化 代码 ,还 提供 了 一 些 高 级 的 函数 比如 WriteMsg 
和 ReadMsg. 另 外 ,下 一 节 我 们 也 将 看 到 , wxSocket 也 使 我 们 可 以 用 流 的 方式 来 操作 socket. 


18.4 使 用 Socket 流 


使 用 wxWidgets 的 流 ,你 仅 使 用 很 少 的 代码 就 可 以 很 容易 传输 很 大 量 的 数据 .现在 ,假设 我 们 要 通 
过 socket 来 传输 一 个 文件 .你 可 能 使 用 的 方法 是 : 打开 这 个 文件 ,将 所 有 的 内 容 读 和 人 内 存 ,然后 将 
这 块 内 存 写 入 到 socket. 这 种 方法 对 于 小 文件 来 说 没什么 问题 ,但 是 如 果 这 个 文件 是 一 个 很 多 兆 
的 大 文件 ,将 其 完整 读 入 内 存 对 于 一 个 速度 和 内 存 都 很 小 的 电脑 来 说 ,显得 有 些 不 太 现实 . 而 且 通 
常 我 们 需要 对 大 文件 进行 压缩 然后 才 发 往 socket 以 便 降低 网 络 流 量 .怎么 办 法 呢 , 把 大 文件 读 入 
内 存 , 对 其 整个 进行 压缩 ,然后 再 一 次 性 发 送 socket, 这 样 得 作法 在 效率 和 实用 性 方面 都 值得 怀 
疑 . 

OK ,我们 来 想 另 外 一 种 办 法 ,每 次 从 文件 里 读 入 一 小 段 数据 ,比如 几 K 数 据 ,然后 将 其 压缩 ,然后 发 
往 socket, 如 此 反复 .不 幸 得 是 , 小 段 压 缩 比 起 整个 文件 一 起 压缩 来 ,压缩 效率 是 大 打折 扣 的 .因此 
我 们 需要 更 进一步 ,维护 一 个 压缩 的 状态 ,以 便 后 面 的 小 段 数据 可 以 使 用 前 面 的 压缩 信息 ,也 可 以 
避免 多 次 传递 压缩 头 信 息 .可 是 到 目前 为 止 ,你 的 代码 已 经 变 的 很 虑 大 了 ,要 分 段 读 取 文 件 ,维护 
压缩 数据 ,压缩 并 且 写 入 socket. wxWidgets 提 供 了 一 种 更 简便 的 方法 . 


为 WxVWidgets 提 供 了 wxSocketlnputStream 和 wxSocketOutputStream 类 ,通过 别 的 流 来 将 数 
据 读 出 或 者 写 入 socket 是 非常 方便 的 .因为 wxWidgets 提 供 了 基于 文件 ,字符 串 , 文 本 ,内 存 以 及 
zlib 压 缩 的 流 操作 ,将 这 些 流 和 socket 流 结合 起 来 使 用 ,可 以 实现 很 有 趣 也 是 很 强大 的 socket 数 
据 操作 方法 .现在 , 回 过 头 来 看 看 我 们 刚才 说 的 通过 socket 压 缩 传输 大 文件 的 问题 ,我 们 可 能 已 经 
找到 了 一 个 更 方便 的 途径 .要 发 送 一 个 文件 ,我 们 可 以 现 将 来 自 文件 的 数据 流通 过 zlib 的 压缩 流 
以 后 发 送 到 socket 的 发 送 流 , 这 样 我 们 一 下 在 就 有 了 强大 的 支持 大 文件 ,支持 压缩 的 ,每 次 只 需要 
读 几 K 的 socket 文 件 传 输 方 法 了 .而 在 接收 端 ,我 们 同样 可 以 使 用 流 操作 将 来 自 socket 流 的 数据 
通过 zlib 解 压缩 流 发 送 到 文件 输出 流 ,最 后 还 原 为 原来 的 文件 .所 有 这 些 可 能 几 行 代码 就 足够 了 . 


我 们 将 使 用 线程 来 处 理 整 个 过 程 ,以 便 我 们 可 以 既 不 占用 100% 的 CPU, 又 不 阻塞 GUI( 正 如 上 一 
小 节 讨 论 的 那样 ), 要 知道 在 使 用 socket 传 输 大 型 的 数据 的 时 候 ,( 如 果 不 使 用 多 线程 ,) 这 种 阻塞 几 
乎 是 不 可 避免 的 . 


完整 的 例子 可 以 在 光盘 的 examples/chap18 目 录 中 找到 . 
文件 发 送 线程 
下 面 的 例子 中 演示 了 流 对 象 在 堆 上 创建 ,FileSendThread 派 生 自 wxThread. 


FileSendThread: :FileSendThread(wxString Filename, 
wxSocketBase* Socket) 
{ 


m_Filename = Filename; 
m_Socket = Socket; 
Create(); 

Run(); 


void* FileSendThread: :Entry() 
{ 
// 如 果 19 秒 之 内 我 们 什么 数据 都 发 送 不 了 ,就 超时 退出 
m_Socket ->SetTimeout (10); 
// 在 所 有 数据 发 送 完成 之 前 , 阻塞 一 切 非 socket 操 作 
m_Socket->SetFlags(wxSOCKET_WAITALL | wxSOCKET_BLOCK); 
// 从 特定 的 文件 流 中 读 入 数据 
wxFileInputStream* FileInputStream = 
new wxFileInputStream(m_Filename) ; 
// 用 来 写 入 socket 的 流 对 象 
wxSocketOutputStream* SocketOutputStream = 
new wxSocketOutputStream(*m_Socket); 
// 我 们 写 入 的 将 是 压缩 以 后 的 数据 
wxZlibOutputStream* ZlibOutputStream = 
new wxZlibOutputStream(*SocketOutputStream) ; 
// 将 文件 的 内 容 写 和 压缩 流 
ZlibOutputStream->write(*FileInputStream) ; 
// 写 所 有 的 数据 
ZlibOutputStream->Sync(); 
// 释放 ZLiboutputStream 将 导致 发 送 z1ib 的 压缩 结束 标记 
delete ZlibOutputStream; 
// 释放 资源 
delete SocketOutputStream; 
delete FileInputStream; 
return NULL; 


文件 接收 线程 


接收 例子 演示 了 相关 流 对 象 也 可 以 在 栈 上 创建 .FileReceiveThread 派 生 自 wxThread. 


FileReceiveThread: :FileReceiveThread(wxString Filename, 
wxSocketBase* Socket) 
{ 


m_Filename = Filename; 
m_Socket = Socket; 
Create(); 

Run(); 


void* FileReceiveThread: :Entry() 
{ 
// 如 果 19 秒 内 什么 也 收 不 到 , 中 止 接收 
m_Socket ->SetTimeout (10); 
// 在 我 们 成 功 接收 完 数据 之 前 , 阻塞 一 切 其 它 的 代码 
m_Socket ->SetFlags(wxSOCKET_WAITALL | wxSOCKET_BLOCKk); 
// 用 于 输出 数据 到 文件 的 流 对 象 
wxFileOutputStream FileOutputStream(m_Filename); 
// 从 socket 接 收 数 据 的 流 对 象 
wxSocketInputStream SocketInputStream(*m_Socket); 
// zlib 解 压缩 流 对 象 
wxZlibInputStream ZlibInputStream(SocketInputStream) ; 
// 将 解压 缩 以 后 的 结果 写 入 文件 
FileOutputStream.Write(ZlibInputStream) ; 
return NULL; 


18.5 蔡 代 WxSocket 


虽然 wxSocket 提 供 了 很 多 有 灵活 性 并 且 被 很 好 的 集成 进 了 wxWidgets, 但 是 它 并 不 是 实现 进程 间 
通信 的 唯一 方法 .如 果 你 只 是 想 进行 FTP 或 者 HTTP 的 操作 ,你 可 以 直接 使 用 wxFTP 或 wxHTTP， 
它们 在 内 部 使 用 了 wxSocket, 不 过 这 些 类 是 不 完善 的 ,你 最 好 还 是 使 用 CURL, 它 是 一 个 通用 的 
库 , 提 供 了 使 用 各 种 Internet 协 议 传递 文件 的 非常 直观 的 APl, 有 人 已 经 对 其 进行 了 wxWidgets 封 
装 ,名 字 叫 做 wxCURL. 


wxWidgets 也 提供 了 一 套 高 级 的 进程 间 通 信 机 制 , 它 使 用 类 wxServer,wxClient 和 wxConnection 
以 及 基于 微软 的 DDE( 动 态 数据 交换 ) 协 议 的 API. 实 际 上 ,在 windows 上 ,这 些 类 是 用 DDE 实 现 的 ， 
而 在 其 它 平 台 上 , 则 是 用 socket 实 现 的 .之 所 以 要 使 用 这 些 更 高 层 的 类 ,是 因为 它 比 直接 使 用 
wxXSocket 更 方便 ,另外 一 个 优点 是 在 windows 平 台 上 ,使 用 DDE 可 以 和 别 的 支持 DDE 的 程序 交换 
数据 ( 别 的 程序 不 必要 是 使 用 wxWidgets 制 作 的 ). 它 的 一 个 缺点 是 在 别 的 平台 上 , 非 wxWidgets 编 
制 的 程序 是 不 能 识别 这 种 协议 的 ,不 过 ,如 果 你 只 需要 在 wxWidgets 制 作 的 程序 之 间 交 换 数据 的 
话 , 它 还 是 可 以 满足 要 求 的 .我 们 将 在 第 20 章 的 "单个 实例 还 是 多 个 实例 ?" 小 节 , 演 示 一 个 简单 的 
例子 . 

更 多 信息 请 参考 WxWidgets 手 册 中 的 "Interprocess Commun-ication Overview"( 进 程 间 通 信 概 


述 ) 小 节 以 及 wxWidgets 自 带 的 samples/ipc 中 的 例子 .你 也 可 以 参考 WxWidgets 自 带 的 独立 帮助 
显示 工具 中 的 代码 , 它 位 于 utils/helpview/src 目 录 内 . 


第 十 八 章 小 结 


我 们 在 这 一 章 里 讨论 了 在 wxWidgets 中 集成 了 wxSocket 类 ,并 且 描述 了 它 和 C 语 言 中 的 socket 
层 的 关系 .为 了 让 socket 编 程 更 容易 , wxWidgets 还 实现 了 socket 的 流 操作 ,以 便 可 以 容易 的 和 别 
的 流 对 象 进行 交互 来 操作 数据 .只 要 你 注意 我 们 在 socket 标 记 小 节 中 讨论 的 那些 可 能 出 现 误 解 
的 地 方 ,相信 你 可 以 使 用 wxSocket 和 其 它 相 关 的 类 制作 出 稳定 的 可 以 在 各 种 平台 上 交叉 编译 的 
socket 程 序 . 


在 下 一 章 里 ,我 们 来 看 看 如 何 使 用 wxWidgets 提 供 的 文档 /视图 框架 来 简化 你 的 应 用 程序 设计 . 


第 十 九 章 使 用 文档 /视图 框 淋 


本 章 来 讨论 一 下 wxWidgets 提 供 的 文档 和 视图 框架 ,通过 使 用 它 , 那 些 基于 文档 的 应用 程序 的 使 
用 的 代码 可 以 大 为 减少 .另外 我 们 还 将 讨论 和 撤消 / 重 做 操作 相关 的 实现 ,我 们 将 介绍 通过 怎样 的 
途径 让 这 个 看 上 去 非常 复杂 的 操作 变 成 很 自然 的 事情 . 


19.1 文档 /视图 基础 


文档 /视图 框架 在 很 多 编程 框架 中 都 专门 提供 了 支持 ,因为 它 可 以 很 大 程度 的 简化 编写 类 似 的 程 
序 需 要 的 代码 量 . 


文档 /视图 框架 主要 是 让 你 用 文档 和 视图 两 个 概念 来 建 模 .所 谓 文 档 , 指 的 是 那些 用 来 存储 数据 和 
提供 用 户 界 面 无 关 的 操作 的 类 ,而 视图 , 指 的 是 用 来 显示 数据 的 那些 类 .这 和 所 谓 的 MVC 模 型 ( 模 
型 -视图 -控制 器 ) 很 相似 ,只 不 过 这 里 把 视图 和 控制 器 合 在 一 起 ,作为 一 个 概念 . 


基于 这 个 框架 ,wxWidgets 可 以 提供 大 量 的 用 户 界 面 控件 和 默认 行为 .你 需要 先 定义 自己 的 派生 
类 以 及 它们 之 间 的 关系 ,框架 本 身 则 负责 显示 文件 选择 ,打开 和 关闭 文件 ,询问 用 户 保存 数据 ,将 
菜单 项 和 对 应 的 代码 关联 ,其 至 一 些 基 本 的 打印 和 预览 功能 ,还 有 就 是 重 做 /撤消 功能 的 支持 等 . 
这 个 框架 已 经 被 高 度 的 模块 化 了 ,允许 你 的 应 用 程序 通过 重 载 和 蔡 换 画 数 和 对 象 的 方式 来 更 改 
这 些 默认 的 行为 ， 


如 果 你 觉得 框架 适合 你 即将 制作 的 程序 ,你 可 以 采用 下 面 的 步 又 来 使 用 这 个 框架 .这 些 步骤 的 顺 
序 并 不 是 非常 的 严格 的 ,你 大 可 以 先 创建 你 的 文档 类 ,然后 再 考虑 你 的 文档 在 应 用 程序 中 的 表现 
形式 . 


1. 决定 你 要 使 用 的 用 户 界面 : 微软 的 MDI (多 文档 界面 ,所 有 的 子 文 档 窗口 被 包含 在 一 个 父 窗 
OA), SDI ( 单 文档 界面 ,每 个 文档 一 个 单独 的 frame 窗 口 ), 或 者 是 单一 界面 (同时 只 能 打开 
一 个 文档 ,就 象 windows 的 写字 板 程 序 那样 ). 

2， 基 于 前 面 的 选择 来 使 用 对 应 的 父 窗口 和 子 窗口 类 ,比如 wxDocParentFrame 和 
wxDocChildFrame 类 . 在 Onlnit 函 数 中 创建 一 个 父 窗口 的 实例 ,对 应 于 每 个 文档 视图 创建 一 
个 子 窗口 的 实例 (如 果 不 是 单 文档 界面 的 话 ). 使 用 标准 的 菜单 标识 符 创建 菜单 (比如 
wxID_OPEN 和 wxID_PRINT)， 

3. 定义 你 自己 的 文档 和 视图 类 , 重 载 尽 可 能 少 的 成 员 画 数 用 于 输入 和 输出 ,绘画 以 及 初始 化 .如 
果 你 需要 重 做 /撤消 的 支持 ,你 应 该 尽早 实现 它 而 不 要 等 到 程序 快 完成 的 时 候 再 回来 返工 . 

4. 定义 任意 的 子 窗口 (比如 一 个 滚动 窗口 ) 用 来 显示 视图 .你 可 能 需要 将 它 的 一 些 事件 传递 给 
视图 或 者 文档 类 人 处理 ,比如 通常 它 的 重 绘 事件 都 需要 传递 给 WXView::OnDraw 辑 数 . 

5， 在 你 的 wxApp::OnInit 画 数 的 开始 部 分 创建 一 个 wxDocManager 实 例 以 及 足够 多 的 
wxDocTemplate 实 例 ,以 便 定义 文档 和 视图 之 间 的 关系 .对 于 简单 的 应 用 程序 来 说 ,一 个 
wxDocTemplate 的 实例 就 可 以 了 . 


我 们 将 用 一 个 简单 的 叫做 Doodle( 参 见 下 图 ) 的 程序 来 演示 上 面 的 步骤 .正如 它 的 名 字 那 样 , 它 支 
持 在 一 个 窗口 上 任意 乱 画 ,并 且 支 持 将 这 些 涂 禾 保 存在 文件 里 或 者 从 文件 里 读 取 . 也 支持 简单 的 
重 做 和 撤消 操作 . 


“= unnamed! 
File Edit Help 





第 一 步 :选择 用 户 界面 类 型 


传统 上 ,windows 平 台 的 多 文档 程序 都 使 用 的 是 多 文档 界面 ,我 们 已 经 在 第 4 章 ," 窗 口 基础 "中 

的 "wxMDIParentFrame" 小 节 对 此 有 过 描述 .多 文档 界面 使 用 一 个 父 fame 窗 口 管理 和 包含 多 个 
文档 子 frame 窗 口 ,而 其 菜单 条 则 用 来 反应 当前 活动 窗口 或 者 父 窗口 (如 果 没 有 当前 活动 窗口 的 
if) 相关 联 的 菜单 命令 . 


或 者 你 也 可 以 选择 使 用 一 个 主 窗 口 ,多 个 顶层 的 用 于 显示 文档 的 frame 窗 口 的 方式 ,这 种 方式 下 
文档 窗口 可 以 不 受 主 窗 口 的 限制 ,在 桌面 上 任意 移动 .这 通常 是 Mac OS 采用 的 风格 ,不 过 在 Mac 
OS 上 ,每 次 只 能 显示 一 个 菜单 条 (当前 活动 窗口 的 菜单 条 ).Mac OS 上 另外 一 个 和 别 的 平台 不 同 
的 地 方 在 于 ,Mac 用 户 并 不 期 望 点 用 程序 的 所 有 的 窗口 被 关闭 以 后 退出 应 用 程序 .Mac 系 统 有 一 
个 应 用 程序 菜单 条 ,上 面 显示 了 的 应 用 程序 所 有 的 窗口 都 隐藏 时 候 可 以 的 少数 的 几 个 命令 ,在 
wxWidgets 上 ,要 实现 这 种 行为 ,你 需要 创建 一 个 不 可 见 的 frame 窗 口 , 它 的 菜单 条 将 在 所 有 其 它 
可 见 窗口 被 释放 以 后 自动 显示 在 那个 位 置 . 


这 种 技术 的 另外 一 种 用 法 是 显示 一 个 主 窗口 之 外 的 非 文 档 视 图 的 frame 窗 口 .不 过 ,这 种 用 法 非 
常 军 见 ,一 般 都 不 会 这 样 使 用 .另外 一 种 方法 是 仅 显 示 文 档 窗口 ,不 显示 主 窗 口 , 仅 在 最 后 一 个 文 
档 窗口 被 关闭 的 时 候 显 示 主 窗口 以 用 来 创建 或 者 打开 新 的 文档 窗口 ,这 种 模型 被 近期 的 
Microsoft Word 采 用 ,这 其 实 是 一 个 和 Mac OS 很 接近 的 作法 ,只 不 过 在 Mac OS 上 ,在 这 种 情况 
下 ,没有 任何 可 见 的 窗口 ,只 有 一 个 菜单 条 . 


也 许 最 简单 的 模型 是 只 有 一 个 主 窗口 ,没有 独立 的 子 窗 口 ,每 次 也 只 能 打开 一 个 文档 :微软 的 写字 
板 就 是 这 样 的 一 个 例子 .这 也 是 我 们 的 Doodle 例 子 所 选择 的 形式 . 


最 后 ,你 当然 也 可 以 创建 自己 的 模型 ,或 者 你 可 以 采用 上 面 这 些 模型 的 组 合 方式 .比如 
DialogBlocks 就 是 这 样 的 一 个 例子 , 它 组 合 了 几 种 方式 以 便 用 户 自己 作出 选择 .DialogBlocks 中 
最 常用 的 是 方式 是 每 次 只 显示 一 个 视图 ,, 当 你 在 工程 树 中 选择 了 一 个 文档 的 时 候 , 当 前 视图 隐 
藏 , 新 的 视图 打开 .你 也 可 以 打开 多 页 面 支持 ,以 便 快速 的 在 你 最 感 兴趣 的 几 个 文档 之 间 切 换 . 另 
外 ,你 还 可 以 通过 拖 搜 标题 栏 的 方式 ,将 某 个 文档 以 单独 的 窗口 拖 动 到 桌面 上 ,以 便 你 可 以 同时 看 
到 几 个 文档 的 视图 .在 DialogBlocks 程 序 内 部 , 它 自己 管理 视图 和 文档 以 及 窗口 之 间 的 关系 ,采用 
的 就 是 和 标准 的 wxWidgets 不 同 的 方式 .很 明显 ,创建 这 样 的 定制 文档 视图 管理 系统 需要 很 多 时 
间 , 因 此 ,你 可 能 更 愿意 选择 wxWidgets 提 供 的 标准 方式 . 


第 二 步 : 创建 和 使 用 frame 窗 口 类 . 


对 于 MDI 界 面 应 用 程序 来 说 ,你 应 该 使 用 wxDocMDIParentFrame 和 wxDocMDIChildFrame 窗 口 
类 ,而 对 于 主 窗口 和 文档 窗口 分 离 的 模型 来 说 ,你 可 以 选择 使 用 wxDocParentFrame 和 
wxDocChildFrame 类 .如 果 你 使 用 的 是 单个 主 窗 口 每 次 打开 一 个 文档 这 种 模型 ,你 可 以 只 使 用 
wxDocParentFrame 类 . 


如 果 你 的 应 用 程序 没有 主 窗口 , 只 有 多 个 文档 窗口 ,你 既 可 以 使 用 wxDocParentFrame, 也 可 以 使 
用 wxDocChildFrame. 不 过 ,如 果 你 使 用 的 是 wxDocParentFrame, 你 需要 拦截 EVT_CLOSE 事 
件 ,以 便 只 删除 和 这 个 窗口 绑 定 的 文档 视图 ,因为 这 个 窗口 类 黑 认 的 EVT_CLOSE 事 件 义理 函数 
将 删除 所 有 文档 管理 器 知道 的 视图 (这 将 导致 关闭 所 有 的 文档 ). 


下 面 列 出 了 doodle 例 子 的 窗口 类 定义 .其 中 保存 了 一 个 指向 doodle 画 布 的 指针 和 一 个 指向 编辑 
菜单 的 指针 ,以 便 文 档 视 图 系统 可 以 视 情况 更 新 重 做 和 撤消 菜单 . 


// 定义 一 个 新 的 frame 窗 口 类 ， 
class DoodleFrame: public wxDocParentFrame 


DECLARE_CLASS(DoodleFrame) 
DECLARE_EVENT_TABLE( ) 
public: 
DoodleFrame(wxDocManager *manager, wxFrame *frame, wxWindowID id, 
const wxString& title, const wxPoint& pos, 
const wxSize& size, long type); 
/// 显示 关于 对 话 框 
void OnAbout(wxCommandEvent& event); 
/// 获得 编辑 菜单 指针 
wxMenu* GetEditMenu() const { return m_editMenu; } 
/// 获得 画布 指针 
DoodleCanvas* GetCanvas() const { return m_canvas; } 
private: 
wxMenu * m_editMenu; 
DoodleCanvas* m_canvas; 


ten 


下 面 的 代码 演示 了 DoodleFrame 的 实现 .其 中 构造 函数 创建 了 一 个 菜单 条 和 一 个 DoodleCanvas 
对 象 ,后 者 拥有 一 个 铅笔 状 的 鼠标 指针 .文件 菜单 被 传递 给 文档 视图 模型 的 管理 对 象 ,以 便 其 可 以 
增加 最 近 使 用 文件 的 显示 . 


IMPLEMENT_CLASS(DoodleFrame, wxDocParentFrame) 
BEGIN_EVENT_TABLE(DoodleFrame, wxDocParentFrame) 
EVT_MENU(DOCVIEW_ABOUT, DoodleFrame: :OnAbout ) 
END_EVENT_TABLE( ) 
DoodleFrame: :DoodleFrame(wxDocManager *manager, wxFrame *parent, 
wxWindowID id, const wxString& title, 
const wxPoint& pos, const wxSize& size, long type): 
wxDocParentFrame(manager, parent, id, title, pos, size, type) 


m_editMenu = NULL; 
m_canvas = new DoodleCanvas(this, 

wxDefaultPosition, wxDefaultSize, 0); 
m_canvas->SetCursor (wxCursor (wxCURSOR_PENCIL) ); 
// 增加 滚动 条 
m_canvas->SetScrollbars(20, 20, 50, 50); 
m_canvas->SetBackgroundColour ( *wxWHITE) ; 
m_canvas->ClearBackground(); 
// 增加 图 标 
SetIcon(wxIcon(doodle_xpm) ); 
// 创建 菜单 
wxMenu *fileMenu = new wxMenu; 
wxMenu *editMenu = (wxMenu *) NULL; 
fileMenu->Append(wxID_NEW, wxT("&New...")); 
fileMenu->Append(wxID_OPEN, wxT("&Open...")); 
fileMenu->Append(wxID_CLOSE, wxT("&Close")); 
fileMenu->Append(wxID_SAVE, wxT("&Save")); 
fileMenu->Append(wxID_SAVEAS, wxT("Save &As...")); 
fileMenu->AppendSeparator(); 
fileMenu->Append(wxID_PRINT, wxT("&Print...")); 
fileMenu->Append(wxID_PRINT_SETUP, wxT("Print &Setup...")); 
fileMenu->Append(wxID_PREVIEW, wxT("Print Pre&view") ); 
editMenu = new wxMenu; 
editMenu->Append(wxID_UNDO, wxT("&Undo")); 
editMenu->Append(wxID_REDO, wxT("&Redo")); 
editMenu->AppendSeparator(); 
editMenu->Append(DOCVIEW_CUT, wxT("&Cut last segment")); 
m_editMenu = editMenu; 
fileMenu->AppendSeparator(); 
fileMenu->Append(wxID_EXIT, wxT("E&xit")); 
wxMenu *helpMenu = new wxMenu; 
helpMenu->Append(DOCVIEW_ABOUT, wxT("&About") ); 
wxMenuBar *menuBar = new wxMenuBar; 
menuBar ->Append(fileMenu, wxT("&File")); 
menuBar ->Append(editMenu, wxT("&Edit")); 
menuBar ->Append(helpMenu, wxT("&Help")); 
// 指定 菜单 条 
SetMenuBar (menuBar ) ; 
// 历史 文件 访问 记录 的 显示 将 使 用 这 个 菜单 . 
manager->FileHistoryUseMenu(fileMenu); 


} 
void DoodleFrame: :OnAbout (wxCommandEvent& WXUNUSED(event) ) 


(void )wxMessageBox(wxT("Doodle Sample\n(c) 2004, Julian Smart"), 
wxT("About Doodle")); 


第 三 步 : 定义 你 的 文档 和 视图 类 


你 的 文档 类 应 该 有 一 个 默认 的 构造 画 数 ,而 且 应 该 使 用 DECLARE_DYNAMIC_CLASS 和 
IMPLEMENT_DYNAMIC_CLASS 宏 来 使 其 提供 RTTI 并 且 支 持 动态 创建 (否则 你 就 需要 重 载 
wxDocTemplate::CreateDocumentH 3X, LA £ HL AY SC RY & Fil 4) 3S EHX). 


你 还 需要 告诉 文档 视图 框架 怎样 保存 和 读 取 你 的 文档 对 象 ,如 果 你 想 直 接 使 用 wxWidgets 流 操 
作 , 你 可 以 重 载 SaveObject 和 LoadObject 函 数 ,就 象 我 们 例子 中 的 作法 一 样 .或 者 你 可 以 直接 重 
#%DoSaveDocumentH 241 DoOpenDocument XX, a 文件 名 而 不 是 流 对 

象 .wxWidget 流 操作 相关 内 容 我 们 已 经 在 第 14 章 ," 文 件 和 流 操作 "中 介 


注意 :框架 本 身 在 保存 数据 的 时 候 不 使 用 临时 文件 系统 .这 也 是 为 什么 我 们 有 时 候 需 要 重 载 
DoSaveDocument 函 数 的 一 个 理由 ,我 们 可 以 通过 流 操作 将 文档 保存 在 wxTempFile 中 ,正如 我 
们 在 第 14 章 中 介绍 的 那样 . 


下 面 是 我 们 的 DoodleDocument 类 的 声明 部 分 : 


* 代表 一 个 Doodle 文 档 
A 


class DoodleDocument: public wxDocument 


DECLARE_DYNAMIC_CLASS(DoodleDocument) 
public: 
DoodleDocument() {}; 
~DoodleDocument(); 
/// 保存 文档 
wxOutputStream& SaveObject(wxOutputStream& stream); 
/// 读 取 文 档 
wxInputStream& LoadObject(wxInputStream& stream); 
inline wxList& GetDoodleSegments() { return m_doodleSegments; }; 
private: 
wxList m_doodleSegments; 


你 的 文档 类 也 许 要 包含 文档 内 容 对 应 的 数据 .在 我 们 的 例子 中 ,我 们 的 数据 就 是 一 个 doodle 片 断 
的 列表 ,每 一 个 数据 片断 代表 从 思 标 按 下 到 鼠标 释放 过 程 中 鼠标 划 过 的 所 有 的 线段 .这 些 片断 所 
属 的 类 知道 怎样 将 自己 保存 在 流 中 ,这 使 得 我 们 实现 文档 保存 和 读 取 的 流 操 作 变 的 相对 容易 .下 
面 是 用 来 代表 这 些 线段 片断 的 类 的 声明 : 


Vax 

* 定义 了 一 个 两 点 之 间 的 线段 

aif 

class DoodleLine: public wxObject 


public: 
DoodleLine(wxInt32 x1 0, wxInt32 y1 
wxInt32 x2 ©, wxInt32 y2 
{ m_x1 = x1; m_y1 = y1; m x2 = x2; m_y2 = y2; } 
wxInt32 m_x1; 
wxInt32 m_y1; 
wxInt32 m_x2; 
wxInt32 m_y2; 


J; 
ips 
* 包含 一 个 线段 的 列表 , 用 来 代表 一 次 鼠标 绘画 操作 
E 
class DoodleSegment: public wxObject 
{ 
public: 
DoodleSegment ( ) {}; 


DoodleSegment (DoodleSegment& seg); 
~DoodleSegment(); 
void Draw(wxDC *dc); 
/// 保存 一 个 片断 
wxOutputStream& SaveObject(wxOutputStream& stream); 
/// 读 取 一 个 片断 
wxInputStream& LoadObject(wxInputStream& stream); 
/// 获取 片断 中 的 线段 列表 
wxList& GetLines() { return m_lines; } 
private: 
wxList m_lines; 


}; 


DoodleSegment 类 知道 怎么 在 某 个 设备 上 下 文 上 绘制 自己 ,这 有 助 于 我 们 实现 我 们 的 doodle 绘 
制 代码 . 


下 面 的 代码 是 这 些 类 的 实现 部 分 : 


Vee 

* DoodleDocument 

A 

IMPLEMENT_DYNAMIC_CLASS(DoodleDocument, wxDocument) 
DoodleDocument: :~DoodleDocument ( ) 


WX_CLEAR_LIST(wxList, m_doodleSegments); 


wxOutputStream& DoodleDocument: :SaveObject(wxOutputStream& stream) 

{ 
wxDocument: :SaveObject(stream) ; 
wxTextOutputStream textStream( stream ); 
wxInt32 n = m_doodleSegments.GetCount(); 
textStream &1t;&lt; n &lt;&lt; wxT('\n'); 
wxList::compatibility_iterator node = m_doodleSegments.GetFirst(); 
while (node) 


{ 
DoodleSegment *segment = (DoodleSegment *)node->GetData(); 
segment ->SaveObject(stream); 
textStream &1t;&lt; wxT('\n'); 
node = node->GetNext(); 
} 


return stream; 


wxInputStream& DoodleDocument: :LoadObject(wxInputStream& stream) 
{ 

wxDocument: :LoadObject(stream) ; 

wxTextInputStream textStream( stream ); 


wxInt32 n = 0; 
textStream &gt;&gt; n; 
for (int i = 0; i &lt; n; i++) 


{ 
DoodleSegment *segment = new DoodleSegment; 
segment ->LoadObject(stream); 
m_doodleSegments.Append(segment) ; 
} 
return stream; 
} 
Vee 
* DoodleSegment 
WA 
DoodleSegment: :DoodleSegment (DoodleSegment& seg) 
{ 
wxList::compatibility_iterator node = seg.GetLines().GetFirst(); 
while (node) 
{ 
DoodleLine *line = (DoodleLine *)node->GetData(); 
DoodleLine *newLine = new DoodleLine(line->m_x1, line->m_y1, line->m_x2, line->m_ 
GetLines().Append(newLine) ; 
node = node->GetNext(); 
} 
} 
DoodleSegment : :~DoodleSegment ( ) 
{ 
WX_CLEAR_LIST(wxList, m_lines); 
} 
wxOutputStream &DoodleSegment: :SaveObject(wxOutputStream& stream) 
{ 
wxTextOutputStream textStream( stream ); 
wxInt32 n = GetLines().GetCount(); 
textStream &1t;&lt; n &lt;&lt; wxT('\n'); 
wxList::compatibility_iterator node = GetLines().GetFirst(); 
while (node) 
{ 
DoodleLine *line = (DoodleLine *)node->GetData(); 
textStream 
&1t;&lt; line->m_x1 &lt;&lt; wxT(" ") 
&1t;&lt; line->m_y1 &1t;&1lt; wxT(" ") 
&1t;&lt; line->m_x2 &lt;&lt; wxT(" ") 
&1t;&lt; line->m_y2 &1t;&1lt; wxT("\n"); 
node = node->GetNext(); 
} 
return stream; 
} 
wxInputStream &DoodleSegment: :_LoadObject(wxInputStream& stream) 
{ 


wxTextInputStream textStream( stream ); 
wxInt32 n = 0; 
textStream &gt;&gt; n; 
for (int i = 0; i &lt; n; i++) 
{ 
DoodleLine *line = new DoodleLine; 
textStream 
&gt;&gt; line->m x1 
&gt;&gt; line->m_y1 
&gt;&gt; line->m x2 
&gt;&gt; line->m_y2; 
GetLines().Append(line); 
} 


return stream; 


void DoodleSegment: :Draw(wxDC *dc) 
{ 
wxList::compatibility_iterator node = GetLines().GetFirst(); 
while (node) 
{ 
DoodleLine *line = (DoodleLine *)node->GetData(); 
dc->DrawLine(line->m_x1, line->m_yi1, line->m_x2, line->m_y2); 
node = node->GetNext(); 


} 


“| 








到 目前 为 止 ,我 们 还 没有 介绍 怎样 将 doodle 片 断 增加 到 我 们 的 文档 中 ,除了 从 文件 读 取 以 外 .我 们 
需要 将 那些 用 来 响应 鼠标 和 键 瘟 操作 ,以 更 改 文档 内 容 的 命令 代码 模型 化 ,这 是 实现 重 做 /撤消 操 
作 的 关键 .DoodleCommand 是 一 个 继承 自 wxCommand 的 类 , 它 实 现 了 虚 函 数 Do 和 Undo, 这 些 
郴 数 将 被 框架 在 合适 的 时 候 调 用 .因此 ,我 们 将 不 会 直接 更 改 文档 内 容 ,取而代之 的 是 在 相应 的 事 
件 饼 理 函 数 中 ,创建 一 个 一 个 的 DoodleCommand 对 象 ,并 将 这 些 对 象 提 交 给 文档 命令 义理 器 (一 
个 wxCommandProcessor 类 的 实例 ) 处 理 .文档 命令 处 理 器 在 执行 这 些 命令 前 会 自动 将 这 些 命 
兮 保存 在 一 个 重 做 /撤消 堆栈 中 .文档 命令 义理 器 对 象 是 在 文档 被 初始 化 的 时 候 被 框架 自动 创建 
的 ,因此 在 这 个 例子 中 你 看 不 到 显 式 创建 这 个 对 象 的 代码 . 


下 面 是 DoodleCommand 类 的 声明 : 


fe 
* 一 个 doodle 命 命 
7A 


class DoodleCommand: public wxCommand 


public: 
DoodleCommand(const wxString& name, int cmd, DoodleDocument *doc, DoodleSegment *seg) 
~DoodleCommand(); 
/// Overrides 
virtual bool Do(); 
virtual bool Undo(); 
/// 重 做 和 撤消 的 命 倒是 对 称 的 , 因此 将 它们 组 合 在 一 起 . 
bool DoOrUndo(int cmd); 
protected: 
DoodleSegment* m_segment; 
DoodleDocument* m_doc; 
int m_cmd; 


* Doodle trix tt 

A 
#define DOODLE_CUT al 
#define DOODLE_ADD 2 


4 -= AA 


我 们 定义 了 两 种 类 型 的 命令 : DOODLE _ ADD 和 DOODLE _CUT 用 户 可 以 删除 最 后 一 次 的 绘画 
操作 或 者 增加 新 的 绘画 操作 .这 里 我 们 的 两 个 命令 都 使 用 同一 个 类 ,不 过 这 不 是 必须 的 .每 一 个 命 
邻 对 象 都 会 保存 一 个 文档 指针 ,一 个 DoodleSegment( 代 表 一 次 绘画 操作 ) 指 针 和 一 个 命令 标识 
符 .下 面 是 DoodleCommand 类 的 实现 部 分 : 


We 
* DoodleCommand 
sk 
DoodleCommand: :DoodleCommand(const wxString& name, int command, 
DoodleDocument *doc, DoodleSegment *seg): 
wxCommand(true, name) 
{ 
m_doc = doc; 
m_segment = seg; 
m_cmd = command; 


DoodleCommand: :~DoodleCommand( ) 


{ 


if (m_segment ) 
delete m_segment; 


an DoodleCommand: :Do() 
: return DoOrUndo(m_cmd); 
boot DoodleCommand: : Undo( ) 
í switch (m_cmd) 
a DOODLE_ADD: 
: return DoOrUndo(DOODLE_CUT); 
ER 


{ 
return DoOrUndo(DOODLE_ADD) ; 
} 


return true; 
} 
bool DoodleCommand: :DoOrUndo(int cmd) 
switch (cmd) 
{ 
case DOODLE_ADD: 
wxASSERT( m_segment != NULL ); 
if (m_segment ) 
m_doc->GetDoodleSegments().Append(m_segment ) ; 
m_segment = NULL; 
m_doc->Modify(true); 
m_doc->UpdateAllViews(); 


break; 


} 
case DOODLE_CUT: 


{ 
wxASSERT( m_segment == NULL ); 
// Cut the last segment 
if (m_doc->GetDoodleSegments().GetCount() &gt; 0) 
{ 
wxList::compatibility_iterator node = m_doc->GetDoodleSegments().GetLast( 
m_segment = (DoodleSegment *)node->GetData(); 
m_doc->GetDoodleSegments().Erase(node); 
m_doc->Modify(true) ; 
m_doc->UpdateAllViews(); 
break; 
} 


} 


return true; 





因为 在 我 们 的 例子 中 Do 和 Undo 操 作 使 用 共用 的 代码 ,我 们 直接 使 用 一 个 DoOrUndo 郴 数 来 实现 
所 有 的 操作 .如 果 我 们 被 要 求 执行 DOODLE_ADD 的 撤消 操作 ,我 们 可 以 直接 执行 
DOODLE_CUT, 而 要 执行 DOODLE_CUT 的 撤消 操作 ,我 们 则 直接 执行 DOODLE_ADD. 


当 增 加 一 个 绘画 片断 (或 者 对 某 个 Cut 命 令 执 行 撤消 操作 ) 时 ,DoOrUndo 郴 数 所 做 的 事情 就 是 把 
个 绘画 片断 增加 到 文档 的 绘画 片断 列表 ,并 且 将 自己 内 部 的 绘画 片断 的 指针 清除 ,以 便 在 释放 


这 
这 个 命 合 对 象 的 时 候 不 需要 释放 这 个 绘画 片断 对 象 . 相 应 的 , 当 执 行 Cut 操 作 ( 或 者 Add 的 Undo 操 


作 ) 的 时 候 ,将 文档 的 片断 列表 中 的 最 后 一 个 片断 从 列表 中 移 除 ,并 且 保 存 其 指针 ,以 便 用 于 相应 
的 恢复 操作 .DoOrUndo 范 数 做 的 另外 一 件 事情 是 将 文档 标记 为 已 修改 状态 (以 便 在 应用 程序 退 
出 时 提醒 用 户 保存 文档 ) 以 及 告诉 文档 需要 更 新 和 自己 相关 的 所 有 的 视图 . 


要 定义 自己 的 视图 类 ,你 需要 实现 wxView 的 派生 类 ,同样 的 ,需要 使 用 动态 创建 的 宏 , 并 至 少 重 载 
OnCreate,OnDraw,OnUpdate#1]OnClose 3X. 


OnCreate EH AXE N A MXH xt FR A AK 6) FEY Bg RGB FB A ee AAT AY oh VE LF: 6 frames HO, 
4 FA SetFrameb BUS EF RIAN BPE. 


OnDraw 画 数 的 参数 为 一 个 wxDC 指 针 , 用 来 实现 窗口 绘制 操作 . 实际 上 ,这 一 步 不 是 必须 的 ,但 是 
一 旦 你 不 使 用 重 载 OnDraw 函 数 的 方法 来 实现 窗口 绘制 ,默认 的 打印 /预览 机 制 将 不 能 正常 工作 . 


OnUpdate 函 数 的 参数 是 一 个 指向 导致 这 次 更 新 操作 的 视图 的 指针 以 及 一 E apis 
人 作 的 对 象 的 指针 .这 个 函数 在 视图 需要 被 更 新 的 时 候 调 用 ,这 通常 意味 着 由 于 执 

行 某 个 文档 命令 导致 相关 视图 需要 更 新 ,或 者 应 用 程序 显 式 调用 ee 
nine 


OnCloseH AA BS ER A AY tH FB RGA & 3 249 A wxDocument::OnCloseHaw* 
闭 视 图 绑 定 的 文档 . 


下 面 是 DoodleView 的 类 声明 .我 们 重 载 了 前 面 介 绍 的 四 个 函数 ,并 且 增 加 了 一 个 DOODLE_CUT 
命 命 的 处 理 画 数 .为 什么 这 里 没有 DOODLE ADD 命 令 的 处 理 画 数 ,是 因为 绘画 片断 是 随 着 起 标 
的 操作 而 增加 的 ,因此 DOODLE_ADD 命 令 对 应 的 视图 动作 已 经 在 DoodleCanvas 对 象 的 鼠标 
处 理 画 数 中 实现 了 .我 们 很 快 就 会 看 到 


JE 
* DoodleView 是 文档 和 窗口 之 间 的 桥梁 . 
A 

class DoodleView: public wxView 


DECLARE_DYNAMIC_CLASS(DoodleView) 
DECLARE_EVENT_TABLE( ) 
public: 
DoodleView() { m_frame = NULL; } 
~DoodleView() {}; 
/// 当 文 档 被 创建 的 时 候 调 用 
virtual bool OnCreate(wxDocument *doc, long flags); 
/// 当 需 要 绘制 文档 的 时 候 被 调用 
virtual void OnDraw(wxDC *dc ) 
/// 当 文 档 需 要 更 新 的 时 候 被 调用 
virtual void OnUpdate(wxView *sender, wxObject *hint = NULL); 
/// 当 视 图 被 关闭 的 时 候 调 用 
virtual bool OnClose(bool deleteWindow = true); 
/// 用 于 处 理 Cut 命 命 
void OnCut(wxCommandEvent& event); 
private: 
DoodleFrame* m_frame; 
}; 


下 面 的 代码 是 其 实现 部 分 : 


IMPLEMENT_DYNAMIC_CLASS(DoodleView, wxView) 
BEGIN_EVENT_TABLE(DoodleView, wxView) 
EVT_MENU(DOODLE_CUT, DoodleView: :OnCut ) 
END_EVENT_TABLE( ) 
// 当 视 图 被 创建 的 时 候 需 要 做 的 动作 
bool DoodleView: :OnCreate(wxDocument *doc, long WXUNUSED(flags)) 
{ 
// 将 当前 主 窗 口 和 视图 绑 定 
m_frame = GetMainFrame(); 
SetFrame(m_frame) ; 
m_frame->GetCanvas()->SetView(this); 
// 让 视图 管理 器 感知 当前 视图 
Activate(true); 
// 初始 化 编辑 菜单 中 的 重 做 /撤消 项 目 
doc->GetCommandProcessor()->SetEditMenu(m_frame->GetEditMenu()); 
doc->GetCommandProcessor()->Initialize(); 
return true; 





} 
// 这 个 玉 数 被 默认 的 打印 /打印 预览 以 及 窗口 绘制 函数 共用 
void DoodleView: :OnDraw(wxDC *dc) 


{ 
dc->SetFont(*wxNORMAL_FONT); 


dc->SetPen(*wxBLACK_PEN ) ; 

wxList::compatibility_iterator node = ((DoodleDocument *)GetDocument 
())->GetDoodleSegments().GetFirst(); 

while (node) 


DoodleSegment *seg = (DoodleSegment *)node->GetData(); 
seg->Draw(dc); 
node = node->GetNext(); 


} 


} 
void DoodleView: :OnUpdate(wxView *WXUNUSED(sender), wxObject *WXUNUSED(hint)) 
{ 


if (m_frame && m_frame->GetCanvas()) 
m_frame->GetCanvas()->Refresh(); 


} 
// 清除 用 于 显 式 这 个 视图 的 窗口 
bool DoodleView: :OnClose(bool WXUNUSED(deleteWindow) ) 


if (!GetDocument()->Close()) 
return false; 
// 清除 画布 
m_frame->GetCanvas()->ClearBackground(); 
m_frame->GetCanvas()->SetView(NULL); 
if (m_frame) 
m_frame->SetTitle(wxTheApp->GetAppName()); 
SetFrame(NULL); 
// 告诉 文档 管理 器 不 要 再 给 我 发 送 任何 事件 了 ， 
Activate(false); 
return true; 


} 
void DoodleView: :OnCut (wxCommandEvent& WXUNUSED(event) ) 
DoodleDocument *doc = (DoodleDocument *)GetDocument(); 


doc->GetCommandProcessor () ->Submit ( 
new DoodleCommand(wxT("Cut Last Segment"), DOODLE_CUT, doc, NULL)); 


第 4 步 : 定义 你 的 窗口 类 


通常 你 需要 创建 特定 的 编辑 窗口 来 维护 你 视图 中 的 数据 .在 我 们 的 例子 中 ,DoodleCanvas 用 来 
显示 对 应 的 数据 ,和 相关 的 事件 交互 等 ,wxWidgets 的 事件 处 理 机 制 也 要 求 我 们 最 好 创建 一 个 新 
的 派生 类 .DoodleCanvas 类 的 声明 如 下 : 


ifr 
* DoodleCanvas 是 用 来 显示 文档 的 窗口 类 
Z 
class DoodleView; 
class DoodleCanvas: public wxScrolledwindow 


DECLARE_EVENT_TABLE( ) 
public: 
DoodleCanvas(wxWindow *parent, const wxPoint& pos, 
const wxSize& size, const long style); 
/// 绘制 文档 内 容 
virtual void OnDraw(wxDC& dc); 
/// 义理 鼠标 事件 
void OnMouseEvent(wxMouseEvent& event); 
/// 设置 和 获取 视图 对 象 
void SetView(DoodleView* view) { m_view = view; } 
DoodleView* GetView() const { return m_view; } 
protected: 
DoodleView *m_view; 


}; 


DoodleCanvas 包 含 一 个 指向 对 应 视图 对 象 的 指针 (通过 DoodleView::OnCreate 辑 数 初始 化 ), 以 
便 在 绘画 和 鼠标 事件 处 理 范 数 中 使 用 .下 面 是 这 个 类 的 实现 部 分 : 


ie 
* Doodle 画 布 的 实现 
2 
BEGIN_EVENT_TABLE(DoodleCanvas, wxScrolledWindow) 
EVT_MOUSE_EVENTS(DoodleCanvas: :OnMouseEvent ) 
END_EVENT_TABLE( ) 
// ERRE 
DoodleCanvas: :DoodleCanvas(wxWindow *parent, const wxPoint& pos, 
const wxSize& size, const long style): 
wxScrolledWindow(parent, wxID_ANY, pos, size, style) 


m_view = NULL; 


} 
// 定制 重 绘 行为 
void DoodleCanvas: :OnDraw(wxDC& dc) 
{ 
if (m_view) 
m_view->OnDraw(& dc); 


} 
// 这 个 画 数 实现 了 主要 的 涂鸦 操 作 , 主要 用 了 和 妃 标 左 键 事件 . 
void DoodleCanvas: :OnMouseEvent (wxMouseEvent& event) 
{ 

// 上 一 次 的 位 置 

static int xpos = -1; 

static int ypos = -1; 

static DoodleSegment *currentSegment = NULL; 

if (!m_view) 

return; 

wxClientDC dc(this); 

DoPrepareDC(dc); 

dc.SetPen( *wxBLACK_PEN); 

// 将 滚动 位 置 计算 在 内 

wxPoint pt(event.GetLogicalPosition(dc)); 

if (currentSegment && event.LeftUp()) 

{ 


if (currentSegment->GetLines().GetCount() == 0) 


delete currentSegment; 
currentSegment = NULL; 


} 


else 
{ 
// 当 最 标 左 键 释放 的 时 候 我 们 获得 一 个 绘画 片断 , 因此 需要 增加 这 个 片断 
DoodleDocument *doc = (DoodleDocument *) GetView()->GetDocument(); 
doc->GetCommandProcessor() ->Submit ( 
new DoodleCommand(wxT("Add Segment"), DOODLE_ADD, doc, currentSegment ) ) ; 
GetView( )->GetDocument()->Modify(true); 
currentSegment = NULL; 


} 


If (xpos &gt; -1 && ypos &gt; -1 && event.Dragging()) 
{ 
if (!currentSegment ) 
currentSegment = new DoodleSegment; 
DoodleLine *newLine = new DoodleLine; 
newLine->m_x1 = xpos; 
newLine->m_y1 = ypos; 
newLine->m_x2 pt.x; 
newLine->m_y2 pt.y; 
currentSegment ->GetLines().Append(newLine) ; 
dc.DrawLine(xpos, ypos, pt.x, pt.y); 


pt.x; 
pt.y; 


= — rl 





正如 你 看 到 的 那样 , 当 狠 标 处 理 范 数 检测 到 一 个 新 的 绘画 片断 被 创建 的 时 候 , 它 提交 给 对 应 的 文 
档 对 象 一 个 DOODLE_ADD 命 邻 , 这 个 命令 将 被 保存 以 便 支 持 撤消 (以 及 将 来 的 重 做 ) 动 作 . 在 我 
们 的 例子 中 , 它 被 保存 在 文档 的 绘画 片断 列表 中 . 


第 5 步 ,使 用 wxDocManager 和 wxDocTemplate 


你 需要 在 应 用 程序 的 整个 生命 周期 内 维持 一 个 wxDocManager 实 例 ,这 个 实例 负责 整个 文档 视 
图 框架 的 协调 工作 . 


你 也 需要 至 少 一 个 wxDocTemplate 对 象 .这 个 对 象 用 来 实现 文档 视图 模型 中 文档 和 视图 相关 联 
的 那 部 分 工作 .每 一 个 文档 /视图 对 , 对 应 一 个 WwxDocTemplate 对 象 ,WxDocManager 对 象 业 管理 
一 个 wxDocTemplate 对 象 的 列表 以 便 用 来 创建 文档 和 视图 . wxDocTemplate 对 象 知道 怎样 的 文 
件 扩 展 名 对 应 目前 的 文档 对 象 以 及 怎样 创建 相应 的 文档 或 者 视图 对 象 等 . 


举例 来 说 ,如 果 我 们 的 Doodle 文 档 支持 两 种 视图 :图 形 视图 和 绘图 片断 列表 视图 ,那么 我 们 就 需 
要 创建 两 种 视图 对 象 (DoodleGraphicView 和 DoodleListView), 相 应 的 我 们 也 需要 创建 两 种 文档 
模板 对 象 , 一 个 用 于 图 形 视图 ,一 个 用 于 列表 视图 . 你 可 以 给 这 两 个 wxDocTemplate 使 用 同样 的 
eee 但 是 传递 不 同 的 视图 类 型 . 当 用 户 点 击 应 用 程序 的 打开 菜单 时 ,文件 
择 对 话 框 将 额外 显示 一 组 可 用 的 文件 过 滤器 ,每 一 个 过 滤器 对 应 一 个 WwxDocTemplate 类 型 , 当 
a ed en (ie 的 wxDocTemplate 创 建 相应 的 文档 类 
和 视图 类 .同样 的 逻辑 也 被 应 用 于 创建 新 对 象 的 时 候 . 当 然 ,在 我 们 的 例子 中 ,只 有 一 种 
wxDocManager 对 象 ,因此 打开 和 新 建文 档 的 对 话 框 就 显得 简单 一 些 了 . 


你 可 以 在 你 的 应 用 程序 种 存储 一 个 wxDocManager 指 针 ,但 是 对 于 wxDocTemplate 通 常 没有 这 
个 必要 ,因为 后 者 是 被 wxDocManager 管 理 和 维护 的 .下 面 是 我 们 的 DoodleApp 类 的 定义 部 分 : 


/* 
* 声 明 一 个 应 用 程序 类 
A 


class DoodleApp: public wxApp 


{ 
public: 
DoodleApp(); 
virtual bool OnInit(); 
virtual int OnExit(); 
private: 
wxDocManager* m_docManager; 


}; 
DECLARE_APP(DoodleApp) 


在 DoodleApp 的 实现 部 分 ,我 们 在 Onlnit 函 数 种 创建 wxDocManager 对 象 和 一 个 和 我 们 的 
DoodleDocument 和 DoodleView 绑 定 的 wxDocTemplate 对 象 .我 们 给 wxDocTemplate 传 递 的 参 
数 包 括 : wxDocManager 对 象 ,描述 字符 串 , 文 件 过 滤器 (在 文件 对 话 框 种 使 用 ), 默 认 打 开 目 录 ( 在 
文件 对 话 框 种 使 用 ), 默 认 的 文件 扩展 名 (.drw, 用 来 区 分 我 们 的 文件 类 型 ) 以 及 我 们 的 文档 和 视图 
类 型 以 及 对 应 的 类 型 信息 .DoodleApp 的 实现 部 分 如 下 所 示 : 


IMPLEMENT_APP(DoodleApp) 
DoodleApp: :DoodleApp( ) 


m_docManager = NULL; 
} 
bool DoodleApp: :OnInit() 


// 创建 一 个 wxDocManager 

m_docManager = new wxDocManager; 

// 创建 我 们 需要 的 wvxDocTemplate 

(void) new wxDocTemplate(m_docManager, wxT("Doodle"), wxT("*.drw"), wxT(""), wxT 
("drw"), wxT("Doodle Doc"), wxT("Doodle View"), 

CLASSINFO(DoodleDocument ), CLASSINFO(DoodleView) ); 

// 在 Mac 系 统 上 登记 文档 类 型 
#ifdef _ WXMAC__ 

wxFileName: :MacRegisterDefaultTypeAndCreator( wxT("drw") , 'WXMB' , 'WXMA' ) ; 
#endif 

// 对 于 我 们 的 单 文档 界面 , 我 们 只 支持 最 多 同时 打开 一 个 文档 

m_docManager ->SetMaxDocsOpen(1); 

// 创建 主 窗口 

DoodleFrame* frame = new DoodleFrame(m_docManager, NULL, wxID_ANY, wxT("Doodle 
Sample"), wxPoint(0, 0), wxSize(500, 400), wxDEFAULT_FRAME_STYLE); 

frame->Centre(wxBOTH) ; 

frame->Show(true); 

SetTopWindow( frame) ; 

return true; 


} 
int DoodleApp: :OnExit() 
{ 
delete m_docManager; 
return 0; 
} 


因为 我 们 只 支持 同时 显示 一 个 文档 ,我 们 需要 通过 函数 SetMaxDocsOpen 告 诉 文档 管理 器 这 一 
点 .为 了 在 Mac OS 上 提供 一 些 额外 的 系统 特性 ,我 们 也 通过 
MacRegisterDefaultTypeAndCreator 函 数 在 Mac 和 系统 中 注册 了 我 们 的 文件 类 型 . 这 个 函数 的 参 
数 为 文件 扩展 名 ,文档 类 型 标识 符 以 及 创建 标识 符 (按照 惯例 通常 采用 四 个 字 节 的 字符 串 来 标识 ， 
你 也 可 以 在 茶 果 公司 的 网 站 上 注册 这 种 类 型 以 避免 可 能 存在 的 冲突 ). 


Doodle 例 子 完整 的 代码 请 参考 附带 光盘 的 examples/chap19/doodle 目 录 . 


19.2 文档 /视图 框 染 的 其 它 能 


上 一 节 中 我 们 通过 一 个 简单 的 例子 演示 了 使 用 文档 视图 框架 所 必须 的 一 些 步骤 ,这 一 节 我 们 来 
讨论 这 个 框架 中 一 些 更 深入 的 话题 . 


标准 标识 符 


文档 /视图 系统 支持 很 多 默认 的 标识 符 ,比如 wxID_OPEN, wxID_CLOSE, wxID_CLOSE_ALL， 
wxlD_REVERT, wxID_ NEW, wxID_SAVE, wxID_SAVEAS, wxID UNDO, wxID_REDO, 
wxID_PRINT 和 wxID_PREVIEW, 为 了 更 大 的 发 挥 框架 的 威力 ,你 应 该 尽 可 能 在 你 的 菜单 或 者 工 
具 栏 中 使 用 这 些 标准 的 标识 符 . 这 些 标识 符 的 处 理 函 数 大 多 已 经 在 wxDocManager 类 中 实现 , 比 
如 OnFileOpen,OnFileClose 和 OnUndo 等 .对 应 的 义理 函数 将 自动 调用 当前 文档 相应 的 处 理 画 
数 .如 SE aS 然 可 以 在 你 的 frame 窗 口 类 或 者 wxDocManager 的 派生 类 中 重 载 这 些 义理 
函数 ,不 过 通常 都 没有 这 个 必要 


打印 和 打印 预览 


默认 情况 下 ,wxID_PRINT 和 wxID te ab ne 印 和 打印 预 
览 ,以 便 直 接 重 用 wxView:: OnDraw 画 数 .然而 ,这 种 用 法 的 一 个 最 大 的 缺陷 是 人 适用 于 只 有 一 
页 的 文档 的 情形 .因此 你 可 以 创建 你 自 i wxID_PRINT 和 
wxID_PREVIEW 钦 理 ,最 快速 的 方法 的 方法 当然 是 使 用 wxHtmlEasyPrinting 类 ,我 们 在 第 12 

章 ," 高 级 窗口 类 "的 "HTML 打 印 "小 结 有 上 比较 详细 的 介绍 


文件 访问 历史 


当 你 的 应 用 程序 初始 化 的 时 候 ,可 以 直接 通过 wxConfig 对 象 使 用 
wxDocManager:FileHistoryLoad 本 数 在 文件 菜单 的 最 下 方 加 载 一 个 文件 访问 历史 列表 ,也 可 以 
在 点 用 程序 退出 之 前 使 用 wxDocManager::FileHistorySave 函 数 保存 这 个 列表 .比如 ,要 加 载 文 
件 访问 历史 ,你 可 以 这 样 做 : 


// 加 载 文件 访问 历史 

wxConfig config(wxT("MyApp"), wxT("MyCompany")); 
config.SetPath(wxT("FileHistory")); 

m_docManager ->FileHistoryLoad(config); 
config.SetPath(wxT("/")); 


如 果 你 是 在 创建 主 窗 口 或 者 其 主 菜单 之 前 加 载 的 文件 访问 历史 ,你 可 以 显 式 的 通过 
wxDocManager:FileHistoryAddFilesToMenu 画 数 将 其 增加 在 菜单 中 . 


你 也 可 以 通过 wxFileHistory 类 或 者 你 自己 的 方法 来 实现 文件 访问 历史 功能 ,比如 有 时 候 你 可 能 
需要 为 每 个 文档 窗口 实现 不 同 的 文件 访问 历史 . 


显 式 创 建文 档 类 


有 时 候 你 需要 显 式 的 创建 一 个 文档 对 象 ,比如 说 ,有 时 候 你 想 打 开 上 次 显 式 的 文档 ,你 可 以 通过 下 
面 的 方式 直接 打开 一 个 已 经 存在 的 文档 ; 


wxDocument* doc = m docManager->CreateDocument(filename， 
wxDOC_SILENT); 


或 者 象 下面 这 样 创建 一 个 新 的 文档 ; 


wxDocument* doc = m_docManager->CreateDocument (wxEmptyString, 
wxDOC_NEW); 


无 论 是 上 面 哪 种 情况 ,都 将 自动 创建 一 个 相应 的 视图 对 象 . 


19.3 实现 Undo/Redo 的 策略 


你 的 应 用 程序 的 Undo/Redo 机 制 的 实现 方法 通常 和 你 文档 的 数据 类 型 以 及 用 户 操作 数据 的 方 
式 有 关 . 在 我 们 的 例子 中 ,我 们 每 次 只 操作 一 整 块 的 数据 ,操作 也 是 很 简单 的 .然而 在 很 多 应 用 程 
序 中 ,用 户 可 以 对 多 种 类 型 的 数据 进行 操作 .在 这 种 情况 下 ,我 们 可 能 需要 使 用 另外 一 种 命令 表示 
方法 ,可 以 称 之 为 CommandState( 状 态 命 令 ), 其 中 包含 了 文档 中 特定 对 象 的 信息 .你 的 命令 类 应 
该 维护 一 个 状态 列表 ,并 且 也 可 以 在 其 构造 本 数 中 接受 这 样 的 状态 列表 参数 .Do 和 Undo 操 作 将 
根据 列表 中 的 状态 并 将 当前 的 命 合 应 用 到 对 应 的 状态 . 


实现 Redo/Undo 操 作 的 关键 ,不 外 乎 以 每 次 一 步 的 方式 向 前 或 者 向 后 通 历 每 个 历史 命令 .因此 ,你 
的 Undo/Redo 实 现 可 以 任意 对 文档 状态 进行 快照 操作 ,以 用 于 将 来 的 恢复 操作 .通过 这 种 方法 无 
论 用 户 进行 多 少 次 向 前 或 者 向 后 的 历史 命令 都 没有 问题 ,你 的 代码 所 需要 作 的 只 是 怎样 确定 " 完 
成 "和 "未 完成 "状态 . 


一 个 常用 的 方法 是 ,在 每 个 命令 状态 中 保存 文档 中 每 个 对 象 的 一 个 拷贝 ,以 及 一 个 指向 实际 对 象 
的 指针 .而 Do 和 Undo 操 作 只 是 简单 的 交换 当前 状态 和 历史 状态 .举例 来 说 ,比如 对 象 是 一 个 图 形 ， 
用 户 将 它 的 颜色 从 红色 改 为 蓝 色 .应 用 程序 于 是 创建 了 一 个 新 的 标识 符 用 来 指示 当前 红色 的 对 

象 ,但 是 它 将 其 内 部 的 颜色 属性 由 红色 设置 为 蓝 色 . 当 这 个 命 合 第 一 次 执行 的 时 候 ,Do 函数 制作 

一 个 当前 的 红色 对 象 的 拷贝 ,并 且 对 其 应 用 这 个 新 的 命 合 ( 包 括 那 个 蓝 颜 色 ), 并 将 其 置 为 可 视 状 
态 ,然后 重 绘 这 个 对 象 ,Undo 作 的 也 是 同样 的 事情 , 它 制作 一 个 当前 蓝 色 对 象 的 拷贝 ,然后 对 齐 应 
用 原来 的 状态 (红色 ), 然 后 重 绘 这 个 对 象 .因此 Do 和 Undo 责 数 其 实 是 完全 一 样 的 .不 光 如 此 ,这 个 
函数 还 可 以 用 于 除 更 改 颜色 以 外 的 其 它 操作 ,因为 整个 对 象 包 括 其 属性 在 内 都 被 制作 了 一 份 捕 

贝 , 你 可 以 通过 给 你 的 应 用 程序 所 能 编辑 的 对 象 单 独 实现 各 自 实现 赋值 和 拷贝 操作 的 构造 本 数 
的 方法 ,使 得 这 整个 过 程 更 直观 . 


让 我 们 举 个 例子 ,以 便 说 的 更 明白 些 .假如 说 ,我 们 的 文档 包含 多 种 形体 ,用 户 可 以 更 改 当 前 选中 
的 所 有 形体 的 颜色 .我 们 可 以 在 相应 的 更 改 颜色 菜单 命令 处 理 郴 数 (比如 
ShapeView::OnChangeColor) 中 ,在 这 个 命令 应 用 于 整个 文档 之 前 ,为 当前 选 种 的 各 个 对 象 创建 
一 个 新 的 状态 拷贝 ,如 下 所 示 : 


// 更 改 当 前 选中 的 形体 的 颜色 
void ShapeView: :OnChangeColor(wxCommandEvent& event) 
{ 
wxColour col = GetSelectedColor(); 
ShapeCommand* cmd = new ShapeCommand(wxT("Change color")); 
ShapeArray arrShape; 
for (size_t i = 0; i &lt; GetSelectedShapes().GetCount(); i++) 
{ 
Shape* oldShape = GetSelectedShapes()[i]; 
Shape* newShape new Shape(*oldShape); 
newShape->SetColor(col); 
ShapeState* state = new ShapeState(SHAPE_COLOR, newShape, oldShape); 
cmd->AddState(state); 


GetDocument() ->GetCommandProcessor()->SubmitCommand(cmd) ; 


为 对 于 我 们 的 ShapeState 对 象 来 说 ,Do 和 Undo 的 操作 都 是 一 样 的 ,因此 我 们 可 以 使 用 一 个 共 
用 的 DoOAndUndo 函 数 , 用 来 进行 状态 交换 的 动作 : 
// 不 完整 的 DoOAndUndo 实 现 


// 对 于 某 些 命令 来 说 , Do 和 Undo 共 用 同样 的 代码 
void ShapeState: :DoAndUndo(bool undo) 


{ 
switch (m_cmd) 
{ 
case SHAPE_COLOR: 
case SHAPE_TEXT: 
case SHAPE_SIZE: 
{ 
Shape* tmp = new Shape(m_actualShape) ; 
(* m_actualShape) = (* m_storedShape); 
(* m_storedShape) = (* tmp); 
delete tmp; 
// 进行 重 绘 动作 
break; 
} 
} 
} 


上 面 的 代码 中 我 们 没有 列 出 ShapeCommand::Do 和 ShapeCommand:Undo 画 数 ,这 两 个 函数 所 
做 的 事情 就 是 通 历 其 成 员 列 表 中 的 所 有 状态 的 相应 函数 . 


( 译 者 注 :这 一 小 节 翻 译 的 似 便 相识 , 云 里 雾 里 ) 


第 十 九重 小 结 


在 这 一 章 里 ,我 们 看 到 了 怎样 通过 wxWidgets 提 供 的 文档 /视图 框架 来 简化 这 种 类 型 的 应 用 程序 
的 编程 ,让 wxWidgets 来 自动 处 理 那 些 显示 文件 对 话 框 或 者 创建 文档 和 视图 对 象 这 种 琐碎 的 工 
作 . 你 也 对 如 果实 现 Undo/Redo 机 制 有 了 一 个 大 概 的 印象 .这 个 机 制 你 应 该 在 你 的 应 用 程序 的 初 
期 就 给 予 充 分 的 考虑 ,否则 到 了 应 用 程序 的 开发 后 期 ,这 些 功 能 的 实现 可 能 导致 你 重 写 大 部 分 的 
Ra. 


在 我 们 的 最 后 一 章 中 ,我 们 将 讨论 一 下 如 何 让 你 的 应 用 程序 显得 更 完美 . 


第 二 十 章 完善 你 的 应 用 程序 


一 个 简朴 可 用 的 应 用 程序 和 一 个 方便 优雅 的 应 用 程序 之 间 有 很 大 的 不 同 . 如 果 只 是 内 部 使 用 , 基 
本 的 不 带 有 很 多 修饰 的 应 用 程序 也 许 是 足够 的 ,但 是 如 果 你 的 应 用 程序 打算 分 发 给 世界 范围 的 
很 多 人 使 用 ,你 应 该 让 它 作 到 更 伟人 信服 和 更 容易 使 用 ,就 像 大 多 数 商 业 软 件 公 司 制 作 的 软件 一 
样 .你 的 软件 应 该 遵守 很 多 约定 俗称 的 惯例 和 标准 ,比如 提供 配置 对 话 框 和 联机 帮助 等 .在 这 本 书 
的 最 后 一 章 , 我 们 将 讨论 下 面 几 个 话题 ,它们 可 以 让 你 的 软件 显得 更 专业 : 


。 单 实 例 程 序 还 是 多 实例 程序 ? 怎样 阻止 同时 运行 你 的 程序 的 多 个 实例 . 

。 更 改 事件 义理 机 制 .怎样 更 改 事件 的 执行 顺序 . 

。 降低 闪 狼 .怎样 通过 降低 闪 狼 的 方法 提高 你 的 应 用 程序 可 视界 面 的 观感 . 

。 实现 在 线 帮 助 .将 给 你 提供 一 些 实现 各 种 联机 帮助 的 建议 . 

。 解析 命令 行 参 数 . 让 你 的 用 户 可 以 通过 命令 行 参数 更 直接 的 控制 你 的 应 用 程序 的 行为 . 

。 保存 应 用 程序 所 用 的 资源 . 介绍 你 打包 各 种 资源 文件 的 方法 . 

。 调用 别 的 应 用 程序 . 从 简单 的 调用 别 的 程序 执行 ,到 控制 别 的 应 用 程序 的 输入 和 输出 方法 . 
。 管理 应 用 程序 设置 . 通过 wxConfig 类 来 保存 和 加 载 应 用 程序 设置 以 及 和 应 用 程序 设置 相关 


的 一 些 提 示 . 
。 应 用 程序 安装 .一 些 关 于 怎么 让 你 的 用 户 可 以 方便 的 在 它们 的 平台 上 安装 你 的 软件 包 的 建 
议 . 


。 遵循 用 户 界面 设计 规范 . 关于 各 个 平台 用 户 界面 设计 规范 方面 的 一 些 建议 . 


20.1 单个 实例 和 多 个 实例 


依照 你 的 应 用 程序 的 性 质 的 不 同 ,你 可 能 允许 你 的 用 户 同时 运行 多 个 你 的 应 用 程序 的 实例 ,或 者 
你 也 可 能 希望 同时 只 能 存在 一 个 你 的 应 用 程序 的 实例 ,如 果 用 户 试图 打开 第 二 个 或 者 试图 通过 
资源 管理 器 打开 多 个 和 你 的 应 用 程序 关联 的 文档 ,它们 都 将 只 看 到 一 个 应 用 程序 在 运行 .一 种 很 
通用 的 作法 是 ,让 你 的 用 户 根据 他 的 工作 习惯 ,自己 选择 是 否 允 许 运行 应 用 程序 的 多 个 实例 .不 过 
同时 运行 多 个 实例 有 一 个 大 问题 是 ,哪个 程序 实例 首先 将 配置 文件 写 入 磁 友 是 不 一 定 的 ,因此 用 
户 可 能 会 丢失 它们 的 设置 .而 且 多 个 实例 运行 对 一 些 新 手 来 说 也 有 麻烦 ,它们 可 能 并 没有 意识 到 
它们 已 经 运行 了 应 用 程序 的 多 个 实例 .允许 同时 运行 应 用 程序 的 多 个 实例 在 所 有 的 平台 上 都 是 
默认 选项 (除了 在 Mac 平 台 上 通过 Finder( 查 找 器 ) 来 启动 应 用 程序 打开 文档 的 时 候 ), 因 此 ,如 果 你 
不 希望 你 的 应 用 程序 可 以 运行 多 个 实例 , 你 需要 一 些 额外 的 代码 . 


在 Mac OS( 也 公 在 这 个 系统 ) 上 ,使 用 单一 实例 打开 多 个 文档 是 非常 容易 的 .你 只 需要 重 载 
MacOpenFile 函 数 ,这 个 函数 采用 一 个 wxString 类 型 的 文件 名 作为 参数 ,这 个 函数 闻 在 Mac Os 的 
Finder 打 开 和 这 个 应 用 程序 关联 的 文档 的 时 候 被 调用 .如 果 当 前 还 没有 运行 任何 这 个 应 用 程序 


打开 文档 通常 是 通过 调用 应 用 程序 并 且 将 文件 名 作为 参数 的 方法 ). 如 果 你 使 用 的 是 文档 /试图 框 
染 , 你 可 能 并 不 需要 重 载 这 个 图 数 ,因为 其 在 Mac OsX 上 的 实现 代码 如 下 : 


void wxApp: :MacOpenFile(const wxString& fileName) 
wxDocManager* dm = wxDocManager::GetDocumentManager() ; 


if ( dm ) 
dm->CreateDocument (fileName, wxDOC_SILENT) ; 


然后 ,即使 在 Mac Os 上 ,用 户 还 是 可 以 通过 直接 多 次 运行 程序 的 方法 运行 你 的 应 用 程序 的 多 个 
实例 . 如 果 你 想 检测 和 禁止 运行 超过 一 个 应 用 程序 实例 ,你 可 以 在 程序 运行 之 初 使 用 
wxSinglelnstanceChecker 类 .这 个 对 象 将 保持 在 应 用 程序 的 整个 生命 周期 ,因此 ,在 你 的 Onlnit 
函数 中 ,调用 其 lsAnotherRunning 函 数 检测 是 否 已 经 有 别 的 实例 正在 运行 ,如 果 返 回 true, 你 可 以 
在 警告 你 的 用 户 之 后 ,立刻 退出 应用 程序 .如 下 所 示 : 


bool MyApp: :OnInit() 
{ 


const wxString name = wxString::Format(wxT("MyApp-%s"), 
wxGetUserId().c_str()); 
m_checker = new wxSingleInstanceChecker (name); 
if ( m_checker->IsAnotherRunning() ) 
{ 
wxLogError(_("Program already running, aborting.")); 
return false; 
} 
. more initializations ... 
return true; 


} 

int MyApp: :OnExit() 

{ 
delete m checker; 
return 0; 

} 


但 是 ,如 果 你 想 把 旧 的 实例 带 到 前 台 , 或 者 你 想 使 用 旧 的 实例 打开 传递 给 你 的 新 的 实例 作为 命令 
行 参数 的 文件 ,该 怎么 办 呢 ? 一 般 说 来 ,这 需要 在 这 两 个 实例 间 进 行 通讯 .我 们 可 以 使 用 
wxWidgets 提 供 的 高 层 进程 间 通 讯 类 来 实现 . 


在 下 面 的 例子 中 ,我 们 将 实现 应 用 程序 多 个 实例 之 间 的 通讯 ,以 便 人 允许 第 二 个 实例 询问 第 一 个 实 
例 是 否 它 自己 打开 相应 的 文件 ,还 是 将 自己 提 到 前 台 以 便 提醒 用 户 它 已 经 请 求 用 这 个 应 用 程序 

来 打开 文件 ,下 面 的 代码 声明 了 一 个 连接 类 ,这 个 类 将 被 两 个 实例 使 用 .一 个 服务 器 类 将 被 老 的 实 
例 使 用 以 便 监 听 别 的 实例 的 连接 请 求 ,一 个 客户 端 类 将 被 后 来 的 实例 使 用 以 便 和 老 的 实例 通讯 . 


#include "wx/ipc.h" 
// Server 类 ,用 来 监听 连接 请 求 
class stServer: public wxServer 


public: 
wxConnectionBase *OnAcceptConnection(const wxString& topic); 
}; 
// Client 类 ,在 OnInit 画 数 中 被 后 来 的 实例 使 用 
class stClient: public wxClient 


public: 
stClient() {}; 
wxConnectionBase *OnMakeConnection() { return new stConnection; } 
J; 
// Connection 类 ,被 两 个 实例 同时 使 用 以 实现 通讯 
class stConnection : public wxConnection 
{ 
public: 
stConnection() {} 
~stConnection() {} 
bool OnExecute(const wxString& topic, wxChar*data, int size, 
wxIPCFormat format); 


下/ 


OnAcceptConnection 函 数 在 老实 例 (Server) 中 当 有 新 实例 (Client) 进 行 连接 请 求 的 时 候 被 调用 . 
我 们 应 该 首先 检查 老实 例 中 没有 显示 任何 模式 对 话 框 ,因为 如 果 有 模式 对 话 框 ,就 不 可 能 有 别 的 
行为 可 以 引起 用 户 的 注意 . 


// 接收 到 了 来 自 别 的 实例 的 连接 请 求 


wxConnectionBase *stServer::OnAcceptConnection(const wxString& topic) 
if (topic.Lower() == wxT("myapp") ) 
// 检查 没有 活动 的 模式 对 话 框 
wxWindowList::Node* node = wxTopLevelWindows.GetFirst(); 


while (node) 


wxDialog* dialog = wxDynamicCast(node->GetData(), wxDialog); 
if (dialog && dialog->IsModal() ) 


return false; 


} 
node = node->GetNext(); 
} 
return new stConnection(); 
} 
else 


return NULL; 


OnExecute 函 数 在 客户 端 实例 对 其 连接 对 象 调用 Execute 函 数 的 时 候 被 调用 . OnExecute 函 数 
可 以 有 一 个 空 的 参数 ,这 表示 它 需 要 将 自己 提 到 前 台 就 可 以 了 ,否则 , 它 需 要 检测 参数 中 的 文件 名 
指示 的 文件 是 否 已 经 被 它 打 开 , 如 果 已 经 打开 ,将 这 个 文件 显示 给 用 户 ,否则 ,就 打开 这 个 文件 ,再 
将 其 显示 给 用 户 . 


// 打开 别 的 实例 传 来 的 文件 参数 . 

bool stConnection: :OnExecute(const wxString& WXUNUSED( topic), 
wxChar *data, 
int WXUNUSED(size), 
wxIPCFormat WXUNUSED( format ) ) 


stMainFrame* frame = wxDynamicCast(wxGetApp().GetTopwWindow(), stMainFrame); 
wxString filename(data) ; 
if (filename.IsEmpty()) 


// 只 需要 提升 主 窗口 
if (frame) 
frame->Raise(); 


} 
else 
{ AEE 
// 检查 文件 是 否 已 经 打开 并 且 将 其 显示 给 用 户 
wxNode* node = wxGetApp().GetDocManager()->GetDocuments().GetFirst(); 
while (node) 
{ 
MyDocument* doc = wxDynamicCast(node->GetData(),MyDocument); 
if (doc && doc->GetFilename() == filename) 
if (doc->GetFrame() ) 
doc->GetFrame()->Raise(); 
return true; 
} 
node = node->GetNext(); 
wxGetApp().GetDocManager ( )->CreateDocument ( 
filename, wxDOC_SILENT); 
} 


return true; 


在 Onlnit 函 数 中 ,应 用 程序 应 该 首先 象 前 面 介绍 的 那样 使 用 wxSinglelnstanceChecker 检 查 是 否 
已 经 运行 了 多 个 实例 ,如 果 没 有 别 的 实例 运行 ,这 个 实例 可 以 将 自己 设置 位 一 个 Server, 等 待 别 的 
应 用 程序 实例 的 连接 请 求 ,如 果 已 经 有 实例 在 运行 ,就 创建 一 个 和 那个 实例 的 连接 ,第 二 个 实例 请 
求 第 一 个 实例 打开 自己 被 请 求 的 文件 或 者 提升 其 主 窗口 .下 面 是 相关 的 代码 : 


bool MyApp: :OnInit() 
wxString cmdFilename; // code to initialize this omitted 


m_singleInstanceChecker = new wxSingleInstanceChecker (wxT("MyApp")); 
// 如 果 使 用 单 实例 ,用 IPC 检 测 是 否 有 别 的 实例 . 
if (!m_singleInstanceChecker ->IsAnotherRunning() ) 
{ 
// 创建 一 个 服务 器 
m_server = new stServer; 
if ( !m_server->Create(wxT("myapp") ) 
{ 


wxLogDebug(wxT("Failed to create an IPC service.")); 


wxLogNull logNull; 
// 0K， 已 经 有 一 个 实例 了 , 创建 一 个 和 它 之 间 的 连接 , 然后 在 自己 退出 之 前 发 送 文件 名 
stClient* client = new stClient; 
// 下 面 的 参数 在 使 用 DDE 的 时 候 被 忽略 , 在 使 用 基于 TCP/IP 的 类 的 时 候 代表 主机 名 . 
wxString hostName = wxT("localhost"); 
// 创建 连接 
wxConnectionBase* connection = 
client ->MakeConnection(hostName, 
wxT("myapp"), wxT("MyApp") ); 
if (connection) 
{ 
// 请 求 那个 已 经 存在 的 实例 打开 文件 或 者 提升 它 自己 
connection->Execute(cmdFilename) ; 
connection->Disconnect(); 
delete connection; 
} 
else 
{ 
wxMessageBox(wxT("Sorry, the existing instance may be 
too busy too respond.\nPlease close any open dialogs and retry."), 
wxT("My application"), wxICON_INFORMATION |wx0k) ; 


delete client; 
return false; 


} 


return true; 


如 果 你 想 要 了 解 更 多 这 里 用 到 的 进程 间 通 讯 的 细节 ,你 可 以 在 wxWidgets 自 带 的 
utils/helpview/src 目 录 中 ,找到 另外 一 个 用 在 独立 的 wxWidgets 帮 助 阅读 器 中 的 例子 ,在 那个 例子 
中 , 别 的 应 用 程序 会 通过 进程 间 通 讯 的 方式 请 求 帮助 阅读 器 程序 打开 某 个 帮助 文件 ,另外 在 
wxWidgets 的 samples/ipc 例 子 中 ,也 演示 了 wxServer, wxClient 和 wxConnection 的 用 法 . 


20.2 更 改 事件 义理 机 制 


在 通常 情况 下 ,wxWidgets 将 事件 发 送 到 产生 这 个 事件 的 窗口 (或 者 别 的 事件 处 理 器 ). 对 于 命 命 
事件 ,还 将 以 特定 的 方式 通 历 整个 窗口 继承 树 (详情 参考 附录 H,"wxWidgets 的 事件 多 理 机 制 ") 来 
处 理 .举例 来 说 ,如 果 你 点 击 工具 条 上 的 任何 一 个 工具 按钮 ,产生 的 事件 将 首先 发 送 给 这 个 工具 按 
钮 的 事件 表 处 理 , 然 后 是 包含 这 个 工具 条 的 frame 窗 口 的 时 间 表 ,然后 是 整个 应 用 程序 类 的 事件 
表 . 通 常情 况 下 ,这 样 的 作法 是 满足 要 求 的 ,但 是 如 果 有 时 候 ,你 希望 超过 一 个 控件 都 可 以 使 用 工 
具 条 上 的 拷贝 命令 的 时 候 ,就 会 有 一 些 问 题 ,比如 ,你 的 主 程序 中 有 一 个 主 窗 口 (假设 是 一 个 绘画 
程序 ) 和 一 个 文本 编辑 框 ,这 个 文本 编辑 框 可 能 永远 也 无 法 处 理工 具 条 上 的 拷贝 命 合 , 因 为 这 个 命 
合并 不 会 调用 这 个 编辑 框 的 事件 处 理 画 数 .在 这 种 情况 下 ,你 可 能 希望 事件 能 够 首先 交 给 当前 多 
于 活动 状态 的 控件 处 理 ,然后 再 按照 正常 的 处 理 顺 序 执行 .这 样 ,如 果 当 前 的 活动 控件 内 部 实现 了 
针对 这 个 事件 的 处 理 函 数 (比如 wxID_COPY), 那 么 这 个 图 数 就 业 被 调用 ,否则 就 在 窗口 继承 树 中 
向 上 查找 对 应 的 多 理 函数 ,直到 它 找到 一 个 这 祥 的 本 数 .这 种 命令 总 是 针对 当前 活动 控件 的 作法 
会 更 符合 用 户 的 使 用 习惯 . 


我 们 可 以 通过 下 面 的 方法 重 载 主 窗口 的 ProcessEvent 函 数 ,以 便 拦 截 命 售 事 件 并 将 其 首先 交 给 
当前 活动 的 控件 处 理 ,如 下 所 示 : 


bool MainFrame: :ProcessEvent(wxEvent& event) 


{ 

static wxEvent* s_lastEvent = NULL; 

// 避免 死 循环 

if (& event == s_lastEvent) 
return false; 

if (event.IsCommandEvent() && 
levent .IsKindOf (CLASSINFO(wxChildFocusEvent)) && 
levent .IsKindOf (CLASSINFO(wxContextMenuEvent ) ) ) 

{ 
s_lastEvent = & event; 
wxControl *focusWin = wxDynamicCast(FindFocus(), wxControl); 
bool success = false; 
if (focusWin) 

success = focusWin->GetEventHandler() 
->ProcessEvent(event); 
if (!success) 
success = wxFrame::ProcessEvent(event); 

s_lastEvent = NULL; 
return success; 

else 
return wxFrame: :ProcessEvent (event); 

} 


就 目前 的 情况 来 看 ,这 种 作法 在 那些 当前 活动 控件 可 能 为 一 个 wxTextCtrl 控 件 的 时 候 显 的 更 有 用 
(在 大 多 数 平台 上 ), wxWidgets 为 这 种 控件 实现 了 多 种 内 置 的 命 命 ,包括 wxID_COPY, 
wxID_CUT, wxID_PASTE, wxID UNDO 和 wxID_REDO, 还 实现 了 一 些 默认 的 用 户 界面 行为 .不 


过 ,你 也 可 以 给 任意 的 控件 通过 实现 其 派生 类 的 方式 增加 这 些 默认 的 事件 处 理 函 数 ,比如 说 
wxStyledTextCtrl 控 件 ( 参 考 examples/chap20/pipedprocess 中 的 例子 ,这 个 例子 为 
wxStyledTextCtrl 控 件 提 供 了 这 种 增强 处 理 ). 


20.3 降低 闪烁 


闪烁 问题 是 所 有 GUI 程序 员 心 中 永远 的 痛 . 通 常 所 有 的 应 用 程序 都 需要 想 办 法 来 降低 可 能 的 闪 
烁 ,下 面 我 们 就 这 方面 的 话题 来 给 您 一 些 有 益 的 提示 . 


在 Windows 平 台 上 ,如 果 你 的 窗口 正在 使 用 wxFULL_REPAINT_ON_RESIZE 类 型 ,尽量 去 掉 它 . 
这 将 导致 窗口 系统 只 重 绘 那 些 由 于 改变 大 小 或 者 别 的 操作 而 被 "破坏 "的 那 部 分 而 不 是 整个 窗 


画 , 从 而 导致 屏幕 闪烁 .不 过 如 果 你 的 程序 中 , 主 窗 口 显 式 的 内 容 是 和 窗口 的 大 小 有 关 的 ,这 种 情 
况 下 ,这 种 方法 毫 无 用 处 ,因为 整个 窗口 必须 被 重新 绘制 . 


有 时 候 你 可 以 设置 wxCLIP_CHILDREN 类 型 ,这 将 阻止 一 个 窗口 发 生 改 变 的 时 候 同时 刷新 它 的 
子 窗口 .不 过 这 个 类 型 在 别 的 平台 上 没有 影响 . 


当 你 在 滚动 窗口 上 绘制 的 时 候 ,你 可 以 采取 很 多 步骤 来 提供 重 绘 的 效率 以 减 小 闪烁 .首先 ,你 需要 
优化 你 获得 绘制 数据 的 方式 :你 只 需要 搜集 那些 可 以 在 当前 的 可 视 区 域内 显示 的 数据 (参考 
wxWindow::GetViewStart 函 数 和 wxWindow:: GetClientSize 函 数 手册 ), 而 且 在 你 的 重 画 函数 内 ， 
你 也 可 以 只 重 画 那 些 处 于 需要 更 新 区 域内 的 图 形 (参考 WxWindow:: GetUpdateRegion). 在 设计 
数据 结构 的 时 候 ,你 应 该 考虑 怎样 设计 才能 使 得 你 可 以 快速 访问 到 当前 视图 对 应 的 数据 ,比如 说 ， 
如 果 你 的 每 个 数据 项 都 有 相同 的 宽度 的 时 候 , 你 可 以 使 用 链表 或 者 数据 来 存放 这 些 数据 ,这 上 比 你 
挨个 搜索 所 有 的 数据 要 快速 的 多 .如 果 计 算 当前 位 置 是 一 个 很 耗 时 的 操作 ,你 可 以 考虑 对 最 近 访 
问 的 页 面 的 起 始 数据 位 置 进行 缓存 .然后 你 可 以 直接 通过 缓存 快速 的 进行 上 一 页 下 一 页 这 样 的 
起 始 数据 定位 动作 .你 也 可 以 为 每 块 数据 增加 一 个 用 来 记录 其 高 度 的 字段 ,以 便 不 必 每 次 都 需要 
计算 这 个 数据 段 的 高 度 . 


当 你 需要 实现 可 以 滚动 的 图 片 时 ,你 可 以 使 用 wxWindow::ScrollWindow 郴 数 ,来 对 窗口 进行 物理 
滚动 ,这 将 使 得 你 只 需要 更 新 剩 下 的 很 小 的 区 域 ,这 将 大 大 降低 闪烁 (wxScrolledWindow 类 已 经 
为 你 实现 了 这 种 机 制 ,GetUpdateRegion 函 数 将 反应 你 需要 更 新 的 这 个 很 小 的 区 域 .) 


正如 我 们 在 第 5 章 ," 绘 画 和 打印 "中 介绍 的 那样 ,你 还 可 以 定义 你 自己 的 背景 擦 除 事件 处 理 函 数 ， 
并 将 其 留 空 ,以 禁止 控件 自己 清除 自己 的 背景 .然后 你 可 以 直接 在 旧 的 图 片上 更 新 整个 图 片 (包括 
整个 背景 所 在 的 范围 ), 以 便 降 低 由 于 在 绘图 前 擦 除 背 景 导 致 的 屏幕 闪烁 .使 用 wxWindow:: 
SetBackgroundStyle 函 数 闻 背景 类 型 设置 为 wxBG_STYLE_CUSTOM 将 阻止 控件 自作 主张 的 
更 新 背景 .第 5 章 还 介绍 了 wxBufferedDC 和 wxBufferedPaintDC, 你 可 以 结合 前 面 提 到 的 这 些 技 
术 一 起 使 用 来 降低 闪烁 . 


另外 一 种 情况 是 由 于 对 一 个 窗口 进行 多 次 连续 的 更 新 导致 窗口 闪烁 .wxWidgets 提 供 了 
wxWindow::Freezec 2X4 wxWindow::Thaw 郴 数 ,这 两 个 函数 可 以 控制 窗口 在 被 更 新 的 时 候 是 
否 立即 显示 在 屏幕 上 .比如 说 ,在 你 需要 往 一 个 文本 框 中 增加 很 多 行文 本 的 时 候 , 或 者 往 一 个 列 
表 框 中 增加 很 多 个 子 项 的 时 候 , 你 可 以 使 用 这 两 个 画 数 . 当 Thaw 男 数 被 调用 的 时 候 , 窗 口才 会 进 
行 彻 底 刷 新 .在 Windows 系 统 和 Mac OSX 系 统 上 ,所 有 的 wxWindow 类 都 支持 Freeze 和 Thaw 函 


数 ,而 在 GTK+ 平 台 上 ,wxTextCtrl 也 支持 这 两 个 函数 .你 也 可 以 在 自己 的 控件 中 实现 这 两 个 本 数 
来 避免 过 度 的 更 新 用 户 界面 (第 12 章 介绍 的 wxThumbnailCtrl 例 子 实现 了 这 两 个 图 数 , 你 可 以 参 
考 examples/chap12/thumbnail 目 录 中 的 代码 ). 


20.4 实现 联机 帮助 


虽然 你 应 该 尽 可 能 的 将 你 的 应 用 程序 界面 设计 的 非常 直观 ,以 便 用 户 根本 不 需要 使 用 联机 帮助 ， 
但 是 除了 那些 最 最 简单 的 应 用 程序 外 ,对 于 大 多 数 应 用 程序 来 说 ,提供 联机 帮助 都 是 一 个 非常 重 
要 的 事情 .你 可 以 提供 PDF 版 的 帮助 文件 或 者 是 HTML 格 式 的 帮助 文件 以 便 用 户 可 以 使 用 他 最 
习惯 的 方式 浏览 ,不 过 如 果 你 能 够 借助 于 某 种 帮助 制作 手段 ,使 得 你 的 联机 帮助 中 的 主题 直接 和 
对 话 框 或 者 你 的 主 窗口 中 的 控件 联系 起 来 ,这 会 让 你 的 用 户 感觉 更 好 . 


wxWidgets 提 供 了 帮助 控制 器 ,你 的 应 用 程序 可 以 使 用 它 来 加 载 和 显示 帮助 文件 中 的 主题 , 它 主 
要 包括 下 面 几 个 类 : 


e wxWinHelpController, 这 个 类 用 来 提供 对 windows 平 台 的 基于 RTF 格 式 的 帮助 文件 (扩展 名 
为 .hlp) 的 支持 . 这 中 格式 现在 已 经 不 推荐 使 用 了 ,新 的 用 来 代替 它 的 类 是 
wxCHMHelpController. 

e wxCHMHelpController, 用 来 提供 对 windows 平 台 的 MS HTML 帮 助 文件 (扩展 名 是 .chm) 的 
支持 . 

e wxWinceHelpController, 用 来 提供 对 WindowsCE 上 的 帮助 文件 (扩展 名 是 .htm) 的 支持 . 

e wxHtmlHelpController, 用 来 提供 对 wxWidgets 自 定义 的 HTML 帮 助 文件 (扩展 名 是 .htb) 的 
支持 . 


wxHtmlHelpController 类 和 别 的 帮助 控制 类 是 不 同 的 , 别 的 类 都 只 是 封装 了 那个 平台 上 相应 的 
本 地 实现 ,而 这 个 类 是 和 wxWidgets 的 帮助 实现 机 制 集成 在 一 起 的 ,和 主 程序 属于 同一 个 进程 . 
如 果 你 想 以 不 同 进程 的 方式 使 用 wxWidgets 提 供 的 帮助 文件 ,你 可 以 编译 wxWidgets 自 带 的 
utils/src/helpview 目 录 下 的 HelpView 程 序 .其 中 文件 remhelp.h 和 remhelp.cpp 实 现 了 一 个 远程 
帮助 文件 控制 器 (wxRemoteHtmlHelpControllem), 你 可 以 将 它 和 你 的 应 用 程序 链接 在 一 起 ,以 便 
你 的 应 用 程序 可 以 远程 控制 位 于 别 的 进程 的 帮助 文件 控制 器 实例 . 


注意 到 目前 为 止 ,还 没有 实现 对 Mac OSX 平 台 上 的 帮助 文件 的 支持 ,在 这 个 平台 上 ,你 可 以 使 用 
通用 的 wxWidgets HTML 格 式 的 帮助 文件 . 


下 面 的 两 副 图 演示 了 Windows 平 台 上 同时 显示 MS HTML 格 式 的 帮助 文件 和 wxWidgets 的 
HTML 帮 助 文件 的 样子 .它们 两 个 的 外 观 很 相似 ,都 是 右边 显示 HTML 帮 助 的 内 容 ,左边 则 显示 主 
题 的 继承 关系 以 及 一 个 用 来 搜索 主题 的 文本 框 .稍微 有 一 点 不 同 的 是 :wxWidgets 格 式 的 帮助 控 
制 器 可 以 同时 加 载 多 个 帮助 文件 . 
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使 用 帮助 控制 器 


一 般 说 来 ,你 需要 创建 一 个 帮助 文件 控制 器 并 且 在 整个 应 用 程序 的 生命 周期 维护 它 ,通常 是 在 应 
用 程序 类 中 保存 一 个 指针 ,在 Oninit 函 数 中 初始 化 ,在 OnExit 范 数 中 释放 .之 所 以 使 用 指针 是 因为 
你 可 以 自己 控制 什么 时 候 释 放 这 个 指针 , 某 些 帮 助 控 制 器 是 依赖 于 某 种 动态 链接 库 类 的 ,这 个 类 
在 应 用 程序 对 象 被 释放 以 后 就 不 存在 了 .在 创建 这 个 帮助 控制 器 指针 以 后 ,使 用 其 Initialize 指 定 
一 个 帮助 文件 .你 可 以 不 用 提供 文件 的 扩展 名 , wxWidgets 将 会 提供 针对 当前 平台 的 扩展 名 , 比 
an: 
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#include "wx/help.h" 
#include "wx/fs_zip.h" 
bool MyApp: :OnInit() 

{ 


// wxWidgets HTML 需 要 这 个 

wxFileSystem: :AddHandler (new wxZipFSHandler ); 
m_helpController = new wxHelpController; 
m_helpController->Initialize(helpFilePath) ; 


return true; 


} 

int MyApp: :OnExit() 

{ 
delete m_helpController; 
return 0; 

} 


注意 这 里 我 们 让 wxWidgets 自 己 决定 使 用 哪个 帮助 控制 器 类 : wxHelpController 在 Windows 平 
台 上 定义 为 WxCHMHelpController 而 在 别 的 平台 上 则 定义 为 wxHtmlHelpController. 你 可 以 在 
windows 平 台 上 也 使 用 wxHtmlHelpController 类 ,不 过 最 好 是 尽 可 能 使 用 本 地 平台 提供 的 帮助 控 
制 器 . 


一 且 帮 助 控制 器 初始 化 成 功 ,你 就 可 以 使 用 下 面 的 函数 显示 相应 的 帮助 了 : 


// 显示 帮助 内 容 

m_helpController->DisplayContents(); 

// 显示 标题 为 "Introduction" 的 主题 
m_helpController->DisplaySection(wxT("Introduction") ); 
// 显示 包含 在 指定 文件 中 的 帮助 主题 . 
m_helpController->DisplaySection(wxT("wx.htm1")); 

// 显示 指定 ID 的 主题 ( 仅 适 用 于 WinHelp 和 MS HTML Help) 
m_helpController->DisplaySection(500); 

// 查找 关键 字 
m_helpController->KeywordSearch(wxT("Getting started")); 


通常 情况 下 ,你 将 在 帮助 菜单 的 事件 义理 函数 中 调用 DisplayContents ,也许 在 帮助 菜单 中 你 还 会 
列举 出 其 它 的 重要 的 主题 ,你 可 以 在 其 对 应 的 事件 处 理 芳 数 中 使 用 DisplaySection 落 数 ,如 果 你 
希望 通过 标题 使 用 DisplaySection 函 数 , 那 么 所 有 的 标题 必须 是 不 重复 的 . 


可 能 你 还 打算 在 所 有 的 自 定义 对 话 框 上 增加 一 个 帮助 按钮 ,以 便 用 来 显示 针对 这 个 对 话 框 的 帮 
助 主题 .然而 ,这 里 有 一 个 需要 注意 的 事情 :不 是 所 有 的 平台 都 支持 从 一 个 模式 对 话 框 的 事件 处 理 
函数 中 显示 帮助 . 当 帮 助 文件 是 通过 一 个 外 部 程序 显示 的 时 候 ( 比 如 Windows 平 台 
wxCHMHelpController), 你 可 以 放心 的 在 模式 对 话 框 中 调用 帮助 控件 ,但 是 如 果 帮 助 控制 器 只 是 
在 本 进程 中 通过 一 个 非 模 式 对 话 框 显示 帮助 文件 时 (比如 wxHtmlHelpController), 你 必须 小 心 , 因 
为 通常 我 们 不 可 以 在 一 个 模式 对 话 框 中 创建 一 个 非 模式 的 frame 窗 口 .模式 对 话 框 不 允许 你 切换 
到 另外 一 个 非 模 式 的 对 话 框 中 .在 wxGTK 平 台 上 ,这 种 行为 仅 对 于 wxHtmlHelpController 来 说 是 
可 以 的 ,但 是 在 Mac OS X 平 台 上 ,这 种 行为 是 不 允许 的 ,这 时 你 可 以 使 用 前 面 介绍 的 使 用 自己 编 
译 的 HelpView 程 序 等 外 部 程序 来 显示 帮助 文件 ,或 者 使 用 模式 对 话 框 来 显示 帮助 文件 ,后 一 种 方 
法 我 们 稍 后 会 进一步 描述 


扩展 wxWidgets HTML 帮 助 


wxWidgets 的 HTML 帮 助 系统 确实 是 很 不 错 的 ,不 过 它 有 两 个 问题 :首先 , 它 只 能 在 自己 的 frame 
窗口 中 显示 帮助 ,因此 你 不 可 以 在 你 的 主 窗口 的 某 个 TAB 控 件 中 显示 帮助 文件 ,另外 一 个 缺陷 是 
前 面 提 到 过 的 在 模式 对 话 框 中 使 用 的 问题 . 


为 了 解决 这 两 个 问题 而 对 wxWidgets HTML 帮 助 系统 进行 的 一 个 扩展 将 wxWidgets 的 帮助 显示 
在 一 个 自 定义 的 窗口 中 ,这 个 窗口 可 以 是 任何 类 型 窗口 的 子 窗口 .你 可 以 从 光盘 的 
examples/chap20/htmlctrlex 目 录 中 或 者 ftp: //biolpc22.york.ac.uk/pub/contrib/helpctrlex 获 取 它 
的 源 代码 . 


如 果 你 将 它 集 成 进 你 的 应 用 程序 ,你 可 以 将 wxHtmlHelpWindowEx 窗 口 集成 进 你 的 主 窗口 ,然后 
使 用 wxHtmlHelpControllerEx 类 来 对 它 进 行 和 别 的 控制 器 一 样 的 控制 来 显示 帮助 内 容 , 下 面 是 
一 个 例子 


#include "helpwinex.h" 
#include "helpctrlex.h" 
bool MyApp: :OnInit() 


m_embeddedHelpController = new wxHtmlHelpControllerEx; 
m_embeddedHelpWindow = new wxHtmlHelpWindowEx; 
m_embeddedHelpWindow->SetController(m_embeddedHelpController); 
m_embeddedHelpController ->SetHelpwindow(m_embeddedHelpWindow) ; 
m_embeddedHelpController ->UseConfig(config, wxT("EmbeddedHelp") ); 
m_embeddedHelpWindow->Create(parentWindow, 
wxID_ANY, wxDefaultPosition, wxSize(200, 100), 
wxTAB_TRAVERSAL | wxNO_BORDER, wxHF_DEFAULT_STYLE); 
m_embeddedHelpController ->AddBook(wxT("book1.htb") ); 
m_embeddedHelpController ->AddBook(wxT("book2.htb")); 
return true; 


} 
int MyApp: :OnExit(void) 


if (m_embeddedHelpController ) 


{ 
m_embeddedHelpController->SetHelpwindow(NULL) ; 
delete m_embeddedHelpController; 

} 

return 0; 


而 为 了 解决 模式 对 话 框 的 问题 ,你 可 以 使 用 wxModalHelp 类 来 在 模式 对 话 框 中 显示 某 个 帮助 主 
题 . 当 用 户 看 完 帮 助 以 后 ,需要 使 用 关闭 按钮 关闭 这 个 帮助 对 话 框 ,然后 焦点 才 会 重新 返回 上 一 个 
模式 对 话 框 中 去 .下 面 的 代码 就 是 你 所 需要 作 的 全 部 : 


wxModalHelp help(parentWindow, helpFile, topic); 


在 同一 个 程序 使 用 两 种 不 同 的 方法 来 显示 帮助 有 时 候 是 很 不 方便 的 ,这 时 候 你 可 以 使 用 下 面 的 
函数 来 节约 一 些 代码 : 


// 如 果 modalParent 不 为 空 , 则 使 用 模式 帮助 显示 方法 , 否则 就 使 用 普通 的 方法 . 
void MyApp: :ShowHelp(const wxString& topic, wxWindow* modalParent ) 


#if USE_MODAL_HELP 
if (modalParent) 


wxString helpFile(wxGetApp().GetFullAppPath(wxT("myapp"))); 
wxModalHelp help(modalParent, helpFile, topic); 


else 
#endif 


if (topic.IsEmpty()) 
m_helpController->DisplayContents(); 


else 
m_helpController->DisplaySection(topic) ; 


宏 USE_MODAL_HELP 应 该 在 那些 使 用 wxHtmlHelpController 控 件 的 平台 上 被 定义 . 当 你 在 模 
式 对 话 框 中 显示 帮助 的 时 候 , 将 这 个 对 话 框 的 指针 作为 ShowHelp 画 数 的 第 二 个 参数 ,这 样 ,如 果 
需要 ,帮助 就 会 显示 在 一 个 模式 的 对 话 框 中 ,而 当 你 不 是 在 模式 对 话 框 中 显示 帮助 的 时 候 ,只 需 
传递 NULL 作 为 ShowHelp 的 第 二 个 参数 . 


帮助 文件 中 的 声明 


大 多 数 现代 的 帮助 文件 系统 都 是 基于 HTML 格 式 的 .为 了 让 跨 平 台 的 帮助 文件 制作 更 容易 一 

些 ,wxWidgets 的 HTML 帮 助 文 件 使 用 了 和 MS 的 HTML 帮 助 文件 同样 的 工程 ,内 容 以 及 关键 字 文 
件 输入 格式 .这 可 以 让 你 在 制作 多 平台 的 帮助 文件 时 ,只 需要 考虑 一 套 文件 就 可 以 了 .下 面 列 举 出 
为 了 创建 帮助 文件 所 需要 的 所 有 的 文件 : 


。 一 套 HTML 文 件 ,每 个 主题 是 一 个 文件 . 

。 一 个 内 容 文件 (扩展 名 是 hhc) 以 XML 的 格式 描述 了 主题 的 继承 关系 . 

。 一 个 可 选 的 关键 字 文 件 (扩展 名 是 hhk) 用 来 将 关键 字 映 射 到 帮助 主题 . 

。 一 个 工程 文件 (扩展 名 是 hhp) 用 来 描述 工程 中 所 有 的 其 它 文件 以 及 整个 工程 的 各 个 选项 ， 


然后 ,你 就 可 以 将 它们 编译 为 MS HTML 帮 助 文件 格式 (扩展 名 为 chm) 或 者 wxWidgets 的 HTML 帮 
助 文件 格式 (扩展 名 是 htb). 对 于 前 者 ,你 需要 使 用 微软 的 HTML 帮 助 制作 软件 (Microsofts HTML 
Help Workshop), 它 既 可 以 从 命令 行 调用 也 可 以 从 GUI 界面 中 被 调用 ,而 对 于 后 者 来 说 ,你 只 需 
使 用 任何 你 喜欢 的 zip 压 缩 工 具 将 所 有 的 这 些 文件 打包 成 一 个 文件 ,将 扩展 名 修改 为 .htb 就 可 以 
aes 


当然 你 可 以 手动 制作 你 的 帮助 文件 ,但 是 使 用 一 个 工具 可 以 节省 你 的 时 间 . 有 很 多 MS HTML 帮 
助 文件 的 制作 工具 ,但 是 它们 有 时 候 会 输出 不 兼容 于 wxWidgets( 不 能 被 wxWidgets 解 析 ) 的 
HTML 标 记 .Anthemion Software 公 司 的 HelpBlocks 软 件 是 目前 唯一 的 可 以 同时 支持 MS HTML 
格式 和 wxWidgets HTML 格 式 的 软件 ,可 以 用 来 帮助 你 制作 帮助 文件 和 分 析 关 键 字 . 


要 了 解 好 的 帮助 文件 的 结构 ,最 好 是 看 看 别人 是 怎么 作 的 .你 可 以 考虑 增加 下 面 的 这 些 主题 :内 
容 ,欢迎 ,联系 信息 ,安装 信息 ,注册 信息 ,发 布 信息 ,教程 ,菜单 使 用 帮助 ,工具 条 使 用 帮助 ,对 话 框 使 
用 帮助 (将 所 有 针对 对 话 框 的 主题 作为 子 标题 ), 快 捷 键 ,命令 行 参数 以 及 故障 解决 等 内 容 . 


记 住 ,应 用 程序 中 各 个 帮助 主题 的 风格 最 好 设计 成 各 自 独立 的 .比如 教程 主题 ,最 好 采用 一 种 比较 
现代 的 风格 . 


你 也 可 以 考虑 使 用 别 的 方法 给 你 的 用 户 提供 帮助 ,比如 使 用 wxWidgets 的 HTML 类 等 .Anthemion 
Software 公 司 的 Writers Caf 依 软件 使 用 一 个 模式 对 话 框 来 实现 一 些 初始 选项 , 它 是 用 
wxHtmlWindow 实 现 的 ,这 些 选 项 包括 显示 一 个 快速 教程 来 通过 一 系列 的 HTML 文 件 演示 这 个 程 
序 的 用 途 (如 下 图 所 示 ). 这 样 作 的 好 处 是 不 言 而 喻 的 ,对 于 您 软件 的 使 用 新 手 来 说 ,这 样 做 可 以 给 
你 的 用 户 提供 一 个 更 狭长 的 学 习 路 径 以 便 你 的 用 户 不 至 于 一 开始 就 被 浩如烟海 的 帮助 给 淹没 ， 
从 而 把 自己 至 于 迷失 的 状态 . 


Welcome to Writers Café Desk 


Q © The main window 


scrapbook index 


Navigate between the major tools with the tool tabs, Manage your scraps in the pane on the left. Get 
quick access to important commands with the toolbar. Time your writing, or other tasks, using the 
timer 





另外 一 个 常用 的 方法 是 提供 每 日 一 学 之 类 的 和 启动 提示 对 话 框 ,这 种 方法 把 应 用 程序 的 功能 分 成 
一 个 一 个 的 小 片 ,然后 每 天 学 习 一 点 点 ,这 很 符合 某 些 人 的 口味 .我 们 在 第 8 章 ," 使 用 标准 对 话 
框 "中 已 经 介绍 了 怎样 使 用 wxShowTip 辑 数 来 显示 这 种 帮助 , 它 的 参数 包括 一 个 父 窗口 ,一 个 
wxTipProvider 指 针 以 便 告 诉 wxWidgets 到 哪里 去 寻找 那些 帮助 信息 ,以 及 一 个 boolean 交 量 以 
便 指 定 除 此 显示 这 个 对 话 框 的 时 候 ,用 于 给 用 户 选 择 是 否 显示 这 种 帮助 的 复 选 框 的 初始 选项 .如 
下 所 示 : 


#include "wx/tipdlg.h" 


m_tipProvider = wxCreateFileTipProvider(tipFilename, currentTip); 
wxShowTip(parent, m_tipProvider, showAtStart); 


上 下 文敏 感 帮助 和 工具 提示 


应 用 程序 应 该 尽 可 能 的 提供 上 下 文敏 感 帮助 和 工具 提示 .所 谓 工 具 提 示 是 指 一 个 很 小 的 提示 窗 
口 ,这 个 窗口 是 当 锯 标 在 某 个 控件 上 提留 一 小 段 时 间 的 时 候 探 出 来 的 .上 下 文敏 感 帮 助 也 和 它 类 
似 ,不 过 它 是 由 用 户 先 点 击 某 个 帮助 按钮 或 者 是 工具 条 上 的 系统 按钮 ,然后 再 点 击 他 感 兴趣 的 控 
件 来 加 以 显示 的 .第 9 章 ," 创 建 定制 的 对 话 框 " 中 ,对 这 些 内 容 有 比较 详细 的 介绍 ,在 那里 我 们 用 来 
介绍 怎样 给 对 话 框 提供 帮助 信息 ,然而 这 些 方法 不 仅仅 只 能 应 用 于 对 话 框 , 它 可 以 应 用 于 任何 一 
种 窗口 类 型 .比如 用 户 可 以 在 工具 条 或 者 帮助 菜单 中 提供 一 个 "这 是 什么 ?" 的 选项 ,以 便 在 用 户 选 
择 这 个 菜单 或 者 点 击 这 个 工具 按钮 以 后 ,对 用 户 随后 点 击 的 窗口 控件 提供 工具 提示 .你 也 不 必 拘 
泥 于 系统 默认 提供 的 帮助 显示 方法 ,你 可 以 自己 重 载 WxHelpProvider 类 来 实现 你 自己 的 
ShowHelp HŽ. 


一 些 控件 支持 使 用 更 本 地 化 的 方法 来 提供 上 下 文敏 感 帮助 ,如 果 你 正在 使 用 
wxCHMHelpController 控 件 ,你 可 以 使 用 它 来 提供 上 下 文敏 感 的 帮助 ,比如 : 


#include "wx/cshelp.h" 
m_helpController = new wxCHMHelpController; 
wxHelpProvider: :Set( 

new wxHelpControllerHelpProvider(m_helpController) ); 


wxHelpControllerHelpProvider % BY 32 (7 5448 FA m_helpControllerAx ” BYDisplayTextPopup 
函数 来 提供 上 下 文敏 感 帮 助 . 


注意 ,提供 上 下 文敏 感 帮 助 和 Mac OSX 的 风格 是 格格 不 入 的 ,因此 在 这 个 平台 你 应 该 忽略 这 种 帮 
助 . 


菜单 项 提示 


当 你 在 菜单 中 加 入 菜单 项 的 时 候 ,你 可 以 提供 一 个 帮助 信息 字符 串 .如 果 这 个 菜单 是 菜单 条 的 一 
部 分 ,而 这 个 菜单 条 所 在 的 fame 窗 口 拥 有 一 个 状态 条 ,那么 当 用 户 鼠 标 在 这 个 菜单 项 上 划 过 的 
时 候 , 这 个 帮助 信息 将 显示 在 状态 栏 上 .你 可 以 通过 wxFrame::SetStatusBarPane 函 数 来 指定 显 
示 这 个 帮助 信息 的 状态 条 方 格 (如 果 设 置 为 -1 则 将 禁止 显示 帮助 信息 ). 这 个 行为 是 在 wxFrame 
的 默认 菜单 项 事件 EVT_MENU_HIGHLIGHT_ALL 的 处 理 画 数 中 实现 的 ,因此 你 可 以 拦截 这 个 
事件 来 提供 你 自己 的 显示 方式 ,比如 将 这 个 帮助 信息 显示 在 另外 的 一 个 窗口 上 . 


20.5 解析 命令 行 参 数 


允许 程序 在 初始 化 的 时 候 分 析 命 令 行 参数 是 很 有 用 的 ,对 于 一 个 文档 视图 架构 的 程序 来 说 ,你 应 
该 允许 程序 通过 这 样 的 方式 打开 文件 .也 可 能 你 想 让 你 的 程序 可 以 从 命令 行 启 动 ,以 便 进 行 一 些 
自动 化 的 工作 ,这 时 候 你 可 以 通过 命令 行 参 数 告诉 你 的 应 用 程序 不 要 显示 用 户 界 面 .虽然 通常 应 
用 程序 的 大 部 分 工作 都 是 通过 用 户 界 面 完 成 的 ,但 是 有 时 候 命令 行 参 数 还 是 很 有 用 的 ,比如 用 它 
来 打开 程序 的 调试 开关 . 


wxWidgets 提 供 了 wxCmdLineParser 类 用 来 简化 这 部 分 的 编程 工作 ,以 避免 你 需要 直接 义理 
wxApp::argc 和 wxApp::argv. 这 个 可 以 处 理 开 关 类 型 参数 (比如 -verbose), 选 项 类 型 参数 (比如 - 
debug:1) 以 及 命令 参数 (比如 "myfile.txt") 等 .对 于 开关 类 型 参数 和 选项 类 型 参数 , 它 允 许 你 设置 
它们 的 长 参数 形式 和 短 参 数 形 式 ,你 还 可 以 给 每 个 参数 提供 一 个 帮助 字符 串 , 这 个 字符 串 将 在 需 
要 显示 使 用 帮助 的 时 候 打 印 在 当前 的 Log 目 标 上 . 


下 面 的 例子 演示 了 怎样 使 用 开关 类 型 ,选项 类 型 等 各 种 参数 : 


#include "wx/cmdline.h" 
static const wxCmdLineEntryDesc g_cmdLineDesc[] = 


{ wxCMD_LINE_SWITCH, wxT("h"), wxT("help"), wxT("displays help on the command line 
parameters") }, 

{ wxCMD_LINE_SWITCH, wxT("v"), wxT("version"), wxT("print version") }, 

{ wxCMD_LINE_OPTION, wxT("d"), wxT("debug"), wxT("specify a debug level") }, 


{ wxCMD_LINE_PARAM, NULL, NULL, wxT("input file"), wxCMD_LINE_VAL_STRING, 
wxCMD_LINE_PARAM_OPTIONAL }, 

{ wxCMD_LINE_NONE } 
J; 
bool MyApp: :OnInit() 


// 分 析 命 使 行 
wxString cmdFilename; 
wxCmdLineParser cmdParser(g_cmdLineDesc, argc, argv); 
int res; 
{ 
wxLogNull log; 
// 传递 False 参 数 以 便 在 分 析 命名 行 发生 错 误 的 时 候 不 显示 使 用 帮助 对 话 框 ， 
res = cmdParser.Parse(false); 
} 
// 检查 是 否 用 户 正在 询问 使 用 帮助 
if (res == -1 || res &gt; © || cmdParser.Found(wxT("h"))) 
{ 
cmdParser .Usage(); 
return false; 
} 
// 检查 是 否 用 户 正在 询问 版 本 号 
if (cmdParser.Found(wxT("v"))) 


{ 
#ifndef _ WXMSW__ 
wxLog: :SetActiveTarget(new wxLogStderr); 
#endif 
wxString msg; 
wxString date(wxString: :FromAscii(__DATE__)); 
msg.Printf(wxT("Anthemion DialogBlocks, (c) Julian Smart, 2005 Version %.2f, %s" 
wbVERSION_NUMBER, (const wxChar*) date); 
wxLogMessage(msg); 
return false; 


} 
// 检查 是 否 用 户 希 望 以 调试 模式 启动 
long debugLevel = 0; 
if (cmdParser.Found(wxT("d"), & debugLevel) ) 
{ 
} 
// 检查 是 否 用 户 传递 了 一 个 工程 名 
if (cmdParser.GetParamCount() &gt; 0) 
{ 
cmdFilename = cmdParser.GetParam(Q); 
// 在 windows 系 统 上 , 如 果 通 过 资源 管理 器 打开 一 个 文件 的 时 候 ， 
// 传递 的 是 短 格式 的 文件 名 
// 因此 我 们 可 以 把 它 变 成 长 格式 文件 名 
wxFileName fName(cmdFilename) ; 
fName .Normalize(wxPATH_NORM_LONG|wxPATH_NORM_DOTS | 
wxPATH_NORM_TILDE |wxPATH_NORM_ABSOLUTE) ; 
cmdFilename = fName.GetFullPath(); 


} 


return true; 


} 
小 | 


使 用 wxFileName 对 文件 名 进行 正常 化 是 必要 的 ,因为 有 时 候 在 以 命令 行 方式 启动 程序 的 时 
候 ,windows 会 传递 短 格式 的 文件 名 . 


正如 我 们 在 前 面 介 绍 的 那样 ,在 MacOSX 上 , 当 打 开 一 个 文档 的 时 候 不 使 用 命令 行 参数 ,而 使 用 直 
接 调用 wxApp:: MacOpenFile 画 数 的 方法 .但 是 命令 行 参 数 的 方法 确实 在 多 数 系统 上 是 被 使 用 
的 ,因此 ,为 了 让 你 开发 的 程序 适用 于 各 种 [平台 ,你 还 是 应 该 提供 命令 行 参 数 的 支持 . 


20.6 存储 应 用 程序 资源 


一 个 简单 的 小 程序 可 能 只 有 一 个 可 执行 文件 .但 是 ,更 常见 的 情形 是 ,你 必须 使 用 包括 帮助 文件 ， 
也 许 还 有 别 的 HTML 文 件 和 图 片 文件 ,以 及 应 用 程序 自 定 义 的 数据 文件 .这 些 附带 的 文件 怎么 存 
储 合适 呢 ? 


减少 数据 文件 的 数量 


你 可 以 通过 一 些 方法 来 减少 你 需要 使 用 的 数据 文件 ,以 便 创 建 一 个 更 简洁 的 发 行 包 .首先 ,对 于 
XPM 类 型 的 图 片 , 尽 可 能 在 你 的 代码 中 使 用 项 nclude, 而 不 是 通过 从 文件 中 读 取 的 方法 来 加 载 
片 .其 次 ,如 果 你 正在 使 用 XRC 文 件 工具 ,位 于 wxWidgets 发 行 版 的 utils/wxrc 目 录 中 的 wxrc 工 具 能 
将 它 变 成 C++ 的 代码 ,如 下 所 示 : 


wxrc resources.xrc --verbose --cpp-code --output resources.cpp 
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第 三 种 方法 是 ,你 可 以 将 所 有 的 数据 文件 打包 成 一 个 zip 文 件 ,然后 使 用 我 们 在 前 面 介 绍 的 流 操 作 
和 虚拟 文件 系统 的 方法 来 访问 它们 .你 可 能 还 需要 用 到 类 wxStandardPaths, 它 定义 

在 "wx/stdpaths.h" 文 件 中 , 它 的 一 些 静 态 的 成 员 男 数 包 括 GetConfigDir, 
GetInstallDir,GetDataDir,GetLocalDataDir 和 GetUserConfigDir 等 .具体 这 些 画 数 在 各 个 平台 
返回 的 目录 的 为 止 参 考 WxWidgets 手 册 中 的 相关 描述 . 


在 Mac OSX 平 台 上 ,你 需要 创建 一 个 应 用 程序 发 布 包 文件 ,这 个 文件 用 来 描述 你 的 应 用 程序 的 可 
执行 文件 路 径 , 数 据 文件 等 .本 章 稍 后 部 分 我 们 会 详细 讨论 有 关 的 情况 . 


找到 应 用 程序 所 在 的 位 置 


经 常会 有 wxWidgets 的 使 用 者 希望 能 够 提供 一 个 画 数 用 来 找到 应 用 程序 所 在 的 绝对 路 径 , 以 便 
可 以 从 同样 的 路 径 加 载 资 源 文件 .不 过 , wxWidgets 并 没有 提供 这 样 的 函数 ,这 部 分 是 因为 要 在 
不 同 的 平台 上 实现 这 些 函 数 是 有 一 定 难 度 的 ,可 能 会 返回 不 可 靠 的 路 径 , 也 是 部 分 出 于 鼓励 开发 
者 最 好 把 数据 文件 放 在 系统 标准 的 数据 文件 夹 中 (尤其 是 在 linux 系 统 上 ) 的 原因 . 然而 ,将 所 有 应 
用 程序 相关 的 文件 都 放 在 一 个 路 径 下 也 是 可 以 理解 的 ,因此 ,在 随 书 光盘 的 
examples/chap20mfindapppath 目 录 中 ,你 可 以 找到 一 个 函数 wxFindAppPath 的 代码 ,用 来 实现 这 
个 功能 , 它 的 声明 部 分 如 下 : 

// 返回 当前 正在 运行 的 可 执行 文件 的 绝对 路 径 

wxString wxFindAppPath(const wxString& argvO, const wxString& cwd, 


const wxString& appVariableName = wxEmptyString, 
const wxString& appName = wxEmptyString); 


argv0 的 值 等 于 wxApp::argv[0], 在 某 些 平台 上 , 它 代 表 了 当前 执行 文件 的 完整 路 径 . 


cwd 是 当前 工作 目录 (你 可 以 通过 调用 wxGetCwd 辑 数 得 到 ), 在 某 些 平台 上 我 们 需要 根据 这 个 参 
数 作 出 一 些 判 断 . 


appVariableName 是 相关 环境 变量 的 值 ,比如 环境 变量 MYAPPDIR, 这 些 变 量 可 以 被 在 程序 外 部 
设置 用 来 指明 应 用 程序 查找 位 置 . 


appName 是 你 在 发 行 包 中 指明 的 前 级 ,函数 可 能 需要 使 用 它 来 检查 位 于 发 行 包 中 的 某 些 路 径 . 比 
如 ,DialogBlocks 程 序 的 这 个 参数 是 DialogBlocks, 因 此 在 Mac OsX 系 统 上 ,这 个 图 数 会 在 
<currentdir>/DialogBlocks.app/Content/MacOS 中 寻找 可 执行 文件 的 全 路 径 . 


下 面 是 这 个 沙 数 的 使 用 方法 举例 : 


bool MyApp: :OnInit() 
wxString currentDir = wxGetCwd(); 
m_appDir = wxFindAppPath(argv[0], currentDir, wxT("MYAPPDIR"), 
wxT("MyApp") ); 


return true; 


} 


在 Windows 平 台 和 Mac OSX 平 台 上 ,这 个 画 数 返回 的 路 径 都 是 可 以 信赖 的 ,然而 在 Unix 平 台 

只 有 应 用 程序 是 从 其 所 在 的 目录 被 启动 的 时 候 , 返 回 的 路 径 才 是 可 以 信赖 的 .或 者 如 果 你 正确 设 
置 了 MYAPPDIR 这 个 环境 变量 ,返回 的 路 径 也 是 可 以 信赖 的 .因此 ,为 了 让 返回 的 值 更 正确 ,有 些 
安装 程序 选择 另外 安装 一 个 启动 脚本 ,这 个 脚本 会 首先 设置 MYAPPDIR 环 境 变量 ,然后 再 启动 应 
用 程序 .你 可 以 选择 提示 用 户 是 否 安装 这 个 脚本 ,或 者 你 可 以 直接 把 你 的 程序 安装 在 标准 的 路 径 
上 ,比如 /usr/local/bin/ 


20.7 调用 别 的 应 用 程序 


有 时 候 你 需要 从 你 的 应 用 程序 中 启动 别 的 应 用 程序 ,可 能 是 一 个 浏览 器 或 者 是 你 自己 写 的 另外 
一 个 程序 .wxExecute 东 数 是 一 个 功能 很 强大 的 范 数 , 它 的 功能 包括 : 带 参 数 或 者 不 带 参 数 调 用 别 
的 程序 ,同步 或 者 异步 执行 程序 ,搜集 别 的 程序 的 输出 ,以 及 重 定向 别 的 程序 的 输入 和 输出 以 便 实 
现 和 当前 程序 的 交互 . 


启动 一 个 应 用 程序 


下 面 是 wxExecute 函 数 的 一 个 简单 的 例子 : 


// 异步 执行 程序 (默认 行为 ), 函数 将 会 立即 返回 . 

wxExecute(wxT("c:\\windows\\notepad.exe")); 

// 同步 执行 程序 , 函数 在 Notepad 程 序 退 出 以 后 才 会 返回 , 

wxExecute(wxT("c:\\windows\\notepad.exe c:\\temp\\temp.txt"), 
wxEXEC_SYNC); 


注意 一 般 来 说 你 可 以 将 参数 和 可 执行 文件 用 引号 括 起 来 ,这 在 路 笃 中 包含 空格 的 时 候 是 很 有 用 
的 . 


打开 文档 


如 果 你 启动 一 个 外 部 程序 的 目的 是 打开 一 个 文档 ,在 Windows 或 者 Linux 平 台 上 ,你 可 以 使 用 
wxMimeTypesManager 类 .你 可 以 使 用 它 来 获得 打开 某 种 类 型 的 文档 所 需要 执行 的 程序 的 路 
径 , 然 后 使 用 它 来 构造 wxExecute 函 数 的 参数 ,比如 ,如 果 你 想 打 开 一 个 HTML 文 件 , 你 可 以 使 用 下 
面 的 方法 : 


wxString url = wxT("c:\\home\\index.html"); 
bool ok = false; 
wxFileType *ft = wxTheMimeTypesManager -> 
GetFileTypeFromExtension(wxT("html") ); 
ane AC ime 9) 
{ 
wxString cmd; 
ok = ft->GetOpenCommand(&cmd, 
wxFileType: :MessageParameters(url, wxEmptyString) ); 


delete ft; 
if (ok) 
it 


ok = (wxExecute(cmd, wxEXEC_ASYNC) != 0); 


不 幸 的 是 ,这 种 方法 不 适用 于 Mac OSX 平 台 , 因 为 Mac OSX 平 台 使 用 完全 不 同 的 文档 打开 机 制 , 
对 于 任何 别 的 文件 类 型 ,最 好 使 用 系统 提供 的 Finder 程 序 来 打开 ,而 对 于 HTML 文 件 ,你 可 以 直接 
使 用 系统 函数 ICLaunchURL.wxExecute 有 时 候 并 不 是 最 好 的 选择 ,在 windows 平 台 上 ,如 果 要 
打开 HTML 文 件 ,你 可 以 直接 使 用 ShellExecute 函 数 会 更 有 效率 .即使 在 Unix 平 台 上 ,你 可 能 也 要 
作 好 指定 的 程序 不 存在 的 准备 ,如 果 它 确实 不 存在 ,你 可 以 考虑 使 用 别 的 程序 比如 htmlview. 


为 了 避免 上 述 的 这 些 问题 ,我 们 在 随 书 光 瘟 的 examples/chap20O/aunch 目 录 中 ,实现 了 一 些 函 数 ， 
比如 : wxLaunchFile,wxViewHTMLFile,wxViewPDFFile,wxPlaySoundFile, 它 们 的 功能 一 目 了 
然 ,并 且 它 们 可 以 同时 支持 Windows,Linux 和 Mac OsX 平 台 . 


wxLaunchFile 是 一 个 普通 意义 上 的 文本 打开 画 数 .参数 包括 一 个 文档 文件 名 或 者 一 个 可 执行 文 
件 名 附带 可 选 的 参数 ,以 及 一 个 可 选 的 错误 消息 字符 串 , 这 个 字符 串 在 执行 失败 的 时 候 显示 给 用 
户 .如 果 当 前 正在 打开 的 文档 是 HTML 类 型 的 文档 ,wxLaunchFile 函 数 将 调用 wxViewHTMLFile 
郴 数 .在 Mac OsX 平 台 上 ,这 个 画 数 将 使 用 Finder 打 开 文 档 , 而 在 别 的 平台 上 则 使 用 
wxMimeTypesManager. 注 意 在 Mac OSX 平 台 上 ,有 时 候 文 档 会 在 非 活动 的 窗口 上 打开 ,这 时 候 
你 可 以 通过 osascript 这 个 命令 行 工 具 来 将 它 提 到 前 台 , 如 下 所 示 ( 比 如 ): 


wxExecute(wxT("osascript -e \"tell application \\\"AcmeApp\\\"\" -e 
\"activate\" -e \"end tell\"")); 


在 Linux 平 台 上 , wxViewHTMLFile, wxViewPDFFile 和 wxPlaySoundFile 都 包含 fallbacks 机 制 以 

便 在 相应 的 可 执行 文件 不 存在 的 时 候 使 用 .你 可 以 按照 自己 的 需要 调整 相应 的 fallbacks 设 置 . 

wxPlaySoundFile 是 用 来 使 用 外 部 程序 播放 那些 大 型 的 声音 文件 的 ,如 果 只 是 播放 一 个 很 小 的 
音 文件 ,你 可 以 直接 使 用 wxSound. 


重 定向 进程 的 输入 和 输出 


有 时 候 ,你 希望 捕获 另外 一 个 进程 的 输入 和 输出 ,以 便 你 或 者 你 的 用 户 可 以 控制 那个 进程 . 比 起 重 
头 写 实现 某 个 功能 的 代码 来 说 ,这 样 作 显然 可 以 给 你 减少 不 少 的 工作 量 .而 wxExecute 可 以 帮助 
实现 捕获 和 控制 那些 控制 台 程 序 的 输入 和 输出 . 


要 实现 这 个 功能 ,你 需要 在 调用 wxExecute 函 数 的 时 候 传递 一 个 wxProcess 的 实例 ,这 个 实例 的 
OnTerminate 函 数 将 在 进程 结束 的 时 候 被 调用 ,这 个 实例 可 以 用 来 捕获 进程 的 输出 或 者 控制 进 
程 的 输入 


在 wxWidgets 自 带 的 samples/exec 目 录 中 ,你 可 以 找到 各 种 各 样 使 用 wxExecute 的 例子 ,我 们 也 
提供 了 另外 一 个 例子 , 它 将 GDB 集 成 进 自己 的 程序 中 去 ,你 可 以 参考 
examples/chap20/pipedprocess 中 的 代码 .我 们 没有 提供 用 于 工具 条 的 那些 小 图 片 以 及 整个 可 
编译 的 代码 ,如 果 提 供 了 这 些 , 它 将 可 以 支持 包括 windows,linux 和 Mac OSX 在 内 的 各 种 平台 ,只 
要 那些 平台 上 安装 了 GDB. 


debugger.h 和 debugger.cpp 文 件 实现 了 一 个 管道 化 的 进程 和 一 个 窗口 ,这 个 窗口 包含 一 个 工具 
条 和 一 个 文本 框 ， ay open aaah: 户 那里 获取 输入 并 且 把 它 发 送 给 GDB. 


textctrlex.h 和 textctrlex.cpp 则 实现 了 一 个 派生 自 wxStyledTextCtrl 的 控件 ,包括 一 些 和 
wxTextCtrl 兼 容 的 函数 和 标准 事件 处 理 函 数 比 如 复制 , 剪 切 ,粘贴 , 重 做 和 撤消 等 . 


processapp.h 和 processapp.cpp 实 现 了 一 个 应 用 程序 类 ,这 个 类 可 以 在 空闲 的 时 候 处 理 来自 多 
个 进程 的 输入 


GDB 是 通过 下 面 的 语句 启动 的 : 


DebuggerProcess *process = new DebuggerProcess (this); 


m_pid = wxExecute(cmd, wxEXEC_ASYNC, process); 


可 以 使 用 下 面 的 代码 杀 死 这 个 进程 : 


wxKill(m_pid, wxSIGKILL, NULL, wxKILL_CHILDREN) ; 


要 给 调试 器 发 送 一 个 命令 ,将 会 设置 一 个 内 部 的 变量 以 便 通 知 应 用 程序 在 空闲 的 时 候 义 理 这 个 


输入 . 


// 给 调试 器 发 送 一 个 命 兮 
bool DebuggerWindow: :SendDebugCommand(const wxString& cmd, 
bool needEcho) 


{ 


if (m_process && m_process->GetOutputStream() ) 
{ 

wxString c = cmd; 

c += wxT("\n"); 

if (needEcho) 

AddLine(cmd); 

// 这 个 函数 只 是 简单 的 对 m_input 变 量 赋值 

// 0nId1le 画 数 中 的 HasInput 画 数 将 检查 这 个 变量 ， 

m_process->SendInput(c); 

return true; 





return false; 


oO 
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并 且 从 进程 读 取 来 自 标准 输出 和 标准 错误 的 输出 : 


bool DebuggerProcess: :HasInput() 

{ 
bool hasInput = false; 
static wxChar buffer[4096]; 
if ( !m_input.IsEmpty() ) 


wxTextOutputStream os(*GetOutputStream()); 
os.WriteString(m_input); 
m_input.Empty(); 
hasInput = true; 


if ( IsErrorAvailable() ) 


buffer[GetErrorStream()->Read(buffer, WXSIZEOF(buffer) - 
1).LastRead()] = _T('\0'); 
wxString msg(buffer); 
m_debug“wWindow->ReadDebuggerOutput(msg, true); 
hasInput = true; 


} 
if ( IsInputAvailable() ) 


{ 
buffer[GetInputStream()->Read(buffer, WXSIZEOF(buffer) - 
1).LastRead()] = _T('\0'); 
wxString msg(buffer); 
m_debugWindow->ReadDebuggerOutput (buffer, false); 
hasInput = true; 


} 


return hasInput; 


注意 上 面 这 个 例子 和 wxWidgets 自 带 的 exec 例 子 的 一 个 关键 的 不 同 在 于 ,exec 例 子 每 次 从 进程 
读 取 一 行 ,如 果 进 程 的 输出 没有 带 换行 符 , 将 导致 应 用 程序 被 阻塞 .而 在 我 们 的 例子 中 ,使 用 了 一 
个 缓冲 区 来 保存 尽 可 能 多 的 输入 ,这 是 一 种 更 安全 的 作法 . 


ProcessApp 类 可 以 直接 被 用 作 你 的 上 应 用 程序 的 基 类 ,或 者 你 可 以 拷贝 它 的 成 员 画 数 到 你 的 上 应 用 
程序 类 中 去 . 它 维护 了 一 个 进程 列表 ,进程 可 以 通过 RegisterProcess 和 UnregisterProcess 回 数 
登记 和 注销 , 进程 输入 和 输出 的 处 理 在 系统 空闲 时 间 完 成 .如 下 所 示 : 


// 任何 缓存 的 输入 都 在 系统 空闲 时 义理 
bool ProcessApp: :HandleProcessInput() 


if (!HasProcesses()) 
return false; 
bool hasInput = false; 
wxNode* node = m_processes.GetFirst(); 
while (node) 


PipedProcess* process = wxDynamicCast(node->GetData(), PipedProcess); 
if (process && process->HasInput()) 
hasInput = true; 
node = node->GetNext(); 
} 


return hasInput; 


} 
void ProcessApp: :OnIdle(wxIdleEvent& event) 


if (HandleProcessInput()) 
event.RequestMore(); 
event .Skip(); 


20.8 管理 应 用 程序 设置 


大 多 数 的 应 用 程序 都 会 给 用 户 一 些 选 项 ,以 便 用 户 自己 决定 一 些 应 用 程序 的 行为 ,比如 是 否 显示 
每 日 提示 ,文本 应 用 什么 字体 ,或 者 是 否 显示 启动 画面 等 .而 程序 员 需 要 作 的 决定 是 怎样 保存 和 显 
示 这 些 配 置 数据 .关于 怎样 存储 ,通常 我 们 需要 使 用 wxConfig 家 族 的 类 ,这 些 类 让 你 可 以 直接 处 
理 类 型 化 的 配置 数据 .至 于 如 何 显示 , 则 是 非常 灵活 的 ,我 们 将 简短 的 介绍 一 些 可 能 的 选项 . 


保存 配置 数据 


所 有 wxWidgets 提 供 的 用 于 处 理 配置 数据 的 类 都 是 wxConfigBase 的 派生 类 ,因此 你 可 以 在 这 个 
基 类 的 手册 中 找到 相关 的 使 用 方法 .而 wxConfig 则 被 定义 为 各 个 平台 上 推荐 使 用 的 用 于 人 处理 配 
置 数据 的 类 :在 windows 平 台 , 它 被 定义 为 WxRegConfig( 这 个 类 使 用 windows 的 注册 表 ), 在 所 有 
别 的 平台 上 它 被 定义 为 WxFileConfig( 它 使 用 文本 文件 ). 另 外 还 有 wxlniConfig 类 , 它 使 用 一 个 

Windows 3.1 风 格 的 .ini 配 置 文 件 , 不 过 这 个 类 很 少 被 使 用 到 .而 wxFileConfig 则 可 以 支持 各 个 平 
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wxString, long, double 和 bool 类 型 等 . 配置 文件 中 的 每 个 项 目 都 需要 提供 一 个 路 径 , 这 个 路 径 
由 "/" 分 割 并 且 最 后 必须 是 一 个 名 称 ,比如 "/General/UseTooltips". 你 可 以 使 用 
wxConfig::SetPath 画 数 设置 一 个 当前 路 径 , 这 样 的 话 , 在 后 续 的 读 守 中 ,如 果 没 有 指定 绝对 路 径 
(以 "开头 ), 所 有 的 路 径 都 被 认为 是 相对 于 这 个 路 径 的 路 径 . 使 用 路 径 的 目的 是 为 了 对 配置 项 进 
行 分 组 . 


wxConfig 的 构造 函数 需要 使 用 应 用 程序 名 和 供应 商 名 称 ,这 两 个 名 称 用 来 决定 配置 项 的 位 置 , 比 
an: 


#include "wx/config.h" 
wxConfig config(wxT("MyApp"), wxT("Acme") ); 


wxRegConfig 将 会 从 应 用 程序 名 和 供应 商 名 称 构造 一 个 注册 表 项 ,比如 前 面 的 例子 中 将 会 导致 
注册 表 项 HKEY_CURRENT_USER/Software/Acme/MyApp 被 创建 .而 如 果 是 Unix 系 统 上 的 
wxFileConfig 类 ,配置 文件 默认 被 保存 在 文件 ~/.MyApp 中 . 而 在 Mac OSX 上 , 则 保存 

在 /Library/Preferences/MyApp/Preferences 中 .这 些 缺 省 位 置 可 以 通过 给 wxConfig 传 递 第 三 个 
参数 来 改变 : 


下 面 是 一 些 wxConfig 的 用 法 : 


// 读 取 
wxString str; 
if (config.Read(wxT("General/DataPath"), & str)) 


bool useToolTips = false; 
config.Read(wxT("General/ToolTips"), & useToolTips)); 
long usageCount = 0; 
config.Read(wxT("General/Usage"), & usageCount) ); 

// BX 

config.Write(wxT("General/DataPath"), str)) 
config.Write(wxT("General/ToolTips"), useToolTips) ); 
config.Write(wxT("General/Usage"), usageCount)); 


其 它 一 些 可 以 使 用 的 操作 包括 比例 组 和 选项 条 目 ,查询 某 个 组 或 者 某 个 选项 是 否 存 在 ,删除 一 个 
条 目 或 者 一 个 组 等 . 


你 可 以 临时 使 用 wxConfig 来 读 取 一 些 存放 在 某 个 地 方 的 数据 ,你 也 可 以 创建 一 个 wxConfig 的 实 
例 并 且 在 应 用 程序 的 整个 生命 周期 维持 它 .wxWidgets 也 有 一 个 称 为 默认 wxConfig 对 象 的 机 制 | 
这 个 默认 的 对 象 可 以 通过 WwxConfig::Set 函 数 设置 .如 果 设 置 了 这 个 默认 对 象 ,一 些 wxWidgets 的 
内 部 实现 将 会 使 用 这 个 对 象 ,比如 wxFontMapper 类 或 者 平台 通用 的 wxFileDialog 实 现 . 


编辑 选项 


如 果 你 只 有 很 少 的 选项 ,那么 普通 的 对 话 框 也 许 就 足够 了 .但 是 有 时 候 , 选 项 有 很 多 ,并 且 非 常 复 
条 ,这 时 候 , 你 可 能 需要 很 多 对 话 框 或 者 面板 , 这 种 情况 下 最 通常 的 作法 是 使 用 包含 一 个 
WwWXxNotebook 的 模式 对 话 框 ,这 个 对 话 框 的 底部 应 该 有 OK,Cancel 或 者 Help 按 钮 .其 中 Help 按 钮 
的 处 理 画 数 将 会 查询 当前 正在 显示 的 页 面 并 显示 一 个 相应 的 帮助 文件 主题 .wxWidgets 提 供 了 
一 个 叫做 wxPropertySheetDialog 的 对 话 框 来 处 理 这 种 情形 .wxWidgets 自 带 的 samples/dialogs 
例子 中 演示 了 它 的 使 用 方法 .在 Pocket PC 上 ,这 个 对 话 框 里 的 notebook 控 件 将 显示 成 屏幕 底部 
标准 的 属性 页 面 . 


你 也 可 以 使 用 wxListbook 和 wxChoicebook 来 代替 wxNotebook, 它 们 是 控制 多 页 控件 的 又 一 个 
选择 .尤其 是 wxListbook, 它 的 API 和 wxNotebook 几 乎 相同 ,但 是 它 使 用 wxListCtrl 而 不 是 TAB 来 
控制 页 标签 ,因此 你 可 以 使 用 图 标 和 标签 来 代替 TAB 按钮 .这 在 你 拥有 很 多 页 面 的 时 候 也 很 有 用 . 
尤其 是 在 Mac OSX 平 台 上 ,这 个 平台 的 wxNotebook 控 件 不 能 够 自己 滚动 标签 按钮 ,因此 标签 按 
钮 的 数目 受 限于 wxNotebook 的 宽度 和 标签 的 宽度 .另外 你 也 可 以 下 载 第 三 方 的 
awxOutbarDialog 控 件 , 它 实现 了 一 个 类 似 Outlook 外 观 的 那 种 多 页 控件 ,使 用 图 标 来 在 页 面 间 切 
换 . 


你 也 可 以 创建 自 定义 的 分 页 管理 对 话 框 ,比如 你 可 以 使 用 wxtreeCtrl 控 件 ,这 可 以 让 你 的 各 个 页 
面 保持 一 种 树 状 的 继承 关系 .要 实现 这 个 自 定 义 控 件 ,你 可 以 维护 一 组 面板 列表 ,每 一 个 都 绑 定 一 
个 名 字 . 当 用 户 点 击 树 状 控件 上 的 某 个 子 项 的 时 候 ,隐藏 当前 正在 显示 的 面板 ,而 显示 树 状 控件 子 
项 对 应 的 面板 .另外 一 个 方案 是 使 用 Jorgen Bodde 制 作 的 wxTreeMultiCtrl 控 件 ,这 个 控件 实现 了 
上 面 所 介绍 的 内 容 ,因此 你 可 以 以 更 直观 的 方法 使 用 树 状 分 页 控件 ,而 不 比 自己 处理 每 个 单独 的 
页 面 . 


你 也 可 以 考虑 使 用 一 个 属性 编辑 框 :这 是 一 个 拥有 一 系列 子 项 ,每 个 子 项 左边 拥有 一 个 文本 标签 ， 
右边 拥有 一 个 编辑 框 .这 个 控件 的 好 处 在 于 增加 和 删除 设置 是 非常 容易 的 ,并 且 不 影响 界面 的 布 
局 .不 好 的 地 方 在 于 ,如 果 你 要 编辑 多 行文 本 或 者 编辑 一 个 列表 就 比较 困难 ,尽管 你 可 以 拦截 子 项 
的 双击 事件 ,使 用 定制 的 对 话 框 来 显示 其 内 容 . 你 可 以 实现 自己 的 属性 编辑 框 ,或 者 你 可 以 考虑 
使 用 wxGrid., 或 者 使 用 第 三 方 的 属性 编辑 控件 比如 Jaakko Salli 的 wxPropertyGrid. 有 些 应 用 程 
序 混合 使 用 了 对 话 框 和 属性 列表 ,比如 DialogBlocks 设 置 对 话 框 的 配置 页 面 . 


你 最 好 不 要 使 用 带 有 滚动 条 的 面板 或 者 对 话 框 来 避免 配置 项 控件 超出 范围 之 外 ,因为 这 会 是 人 
感觉 迷惑 并 且 也 是 很 医 陋 的 . 


你 应 该 考虑 将 你 应 用 程序 的 所 有 设置 保存 在 一 个 统一 的 类 中 ,并 且 为 这 个 类 实现 一 个 拷贝 构造 
玫 数 ,一 个 等 于 操作 以 及 一 个 赋值 操作 .通过 这 种 方法 ,你 可 以 很 容易 的 创建 一 个 所 有 配置 项 的 副 
本 ,将 其 传递 给 你 的 配置 对 话 框 ,并 且 仅 仅 在 用 户 点 击 了 配置 对 话 框 上 的 OK 按钮 的 时 候 , 才 将 修 
改 的 数据 保存 回 你 的 全 局 配置 中 . 


如 果 你 没有 单独 的 保存 各 个 配置 项 ,你 需要 给 你 的 用 户 提供 一 种 直接 修改 配置 的 方法 .参考 光 鼻 
中 的 examples/chap20/valconfig 例 子 .其 中 包含 了 一 个 类 wxConfigValidator, 这 个 类 可 以 用 来 作 
普通 控件 的 验证 器 , 它 的 参数 包括 配置 项 路 径 , 配 置 项 类 型 以 及 一 个 指向 wxConfig 对 象 的 指 

针 . 其 中 值 类 型 可 以 是 wxVAL_BOOL, wxVAL_STRING 或 者 wxVAL_LONG. 如 下 所 示 : 


void MyDialog: :SetValidators(wxConfig* config) 


FindWindow( ID_LOAD_LAST_DOCUMENT )->SetValidator ( 
wxConfigValidator(wxT("LoadLastDoc"), wxVAL_BOOL, config)); 
FindWindow( ID_LAST_DOCUMENT )->SetValidator( 
wxConfigValidator(wxT("LastDoc"), wxVAL_STRING, config)); 
FindWindow( ID_MAX_DOCUMENTS) ->SetValidator ( 
wxConfigValidator (wxT("MaxDocs"), wxVAL_LONG, config)); 


第 9 章 中 介绍 了 更 多 关于 验证 器 的 知识 .本 节 提 到 的 那些 第 三 方 控件 可 以 在 附录 E,"wxWidgets 
的 三 方 控件 "中 找到 ， 


20.9 应 用 程序 安装 


如 果 你 的 应 用 程序 可 以 很 顺利 的 安装 到 用 户 的 电脑 上 ,这 无 疑 在 用 户 开始 使 用 你 的 程序 之 前 就 
给 用 户 一 个 很 不 错 的 第 一 印象 .在 这 一 节 里 ,我 们 将 依次 介绍 在 Windows,Linux 和 OsX 平 台 上 怎 
样 制作 安装 程序 ,其 中 涉及 到 的 一 些 第 三 方 工 具 可 以 在 附录 E 中 找到 . 


在 Windows 系 统 上 安装 你 的 程序 


在 windows 平 台 上 ,我 们 尤其 需要 一 个 安装 程序 ,这 不 只 是 因为 用 户 期 待 这 样 ,而 且 安装 程序 还 需 
要 作 一 些 类 似 文件 类 型 绑 定 和 创建 快捷 方式 这 样 的 动作 . 


不 够 这 实在 和 wxWidgets 所 关注 的 邻 域 差 别 太 大 ,因此 wxWidgets 并 不 准备 自己 提供 这 样 的 工 
具 .一 些 另外 的 工具 可 以 用 来 创建 安装 程序 ,比如 NSIS 和 InstallShield; 另外 一 个 广 受 好 评 的 软件 
是 Inno Setup, 它 是 一 个 非常 强大 的 ,免费 的 安装 程序 制作 工具 , 它 可 以 通过 脚本 来 定制 安装 文件 
选项 ,通过 Pascal 语 言 来 对 其 现 有 功能 进行 扩展 . 它 的 网 站 上 也 列举 了 一 些 用 来 创建 安装 脚本 的 
图 形 界 面 工具 . 


如 果 你 需要 很 频繁 的 发 布 新 的 版 本 ,你 可 能 想 要 通过 一 个 脚本 自动 创建 安装 程序 . 随 书 光盘 的 
examples/chap20/install 目 录 中 提供 了 一 个 用 于 创建 这 样 的 脚本 的 例子 ,你 可 以 按 你 的 需要 进 
行 更 改 .因为 它们 是 Unix 风 格 的 Shell 脚 本 ,需要 你 有 MingW 或 者 MSys 的 环境 ,这 些 环境 也 有 在 
随 书 光盘 中 提供 .你 需要 提供 的 包括 一 个 放置 文件 的 目录 ,makeinno.sh 脚 本 将 会 创建 Inno 
Setup 的 脚本 中 枚 举 子 目录 和 文件 的 部 分 .而 安装 脚本 的 头 和 尾部 那些 需要 你 自己 按照 自己 软件 
的 情况 提供 的 部 分 将 不 会 被 自动 创建 .你 可 以 使 用 下 面 的 命令 来 创建 安装 文件 : 


sh makeinno.sh c:/temp/imagedir innotop.txt innobott.txt myapps.iss 


这 将 会 基于 文件 夹 cjtemp/imagedir 中 的 文件 创建 Inno Setup 的 脚本 文件 myapp.iss. 


你 可 以 调整 makesetup.sh 脚 本 来 创建 你 需要 的 安装 程序 ,这 个 文件 首先 将 需要 的 文件 拷贝 到 一 
个 "images" 文 件 夹 (就 是 前 面 makeinno.sh 脚 本 需要 的 那个 文件 夹 ), 然 后 创建 setup.exe. 这 个 脚 
本 使 用 了 定义 在 setup.var 中 的 变量 .你 可 以 按照 你 自己 的 情况 增加 新 的 功能 ,比如 编译 你 的 应 用 
程序 或 者 使 用 Cunl 工 具 拷贝 文件 到 你 的 FTP 站 点 等 . 


当 你 发 布 应 用 程序 的 时 候 , 别 忘 了 增加 一 个 WindowsXp 的 "manifest" 文 件 . 这 个 文件 是 一 个 Xml 
格式 的 文件 ,用 来 告诉 WindowsXp 应 该 给 这 个 程序 应 用 什么 风格 .你 可 以 通过 在 你 的 程序 的 资 
源 文件 (.rc) 中 增加 wxWidgets 标 准 资源 文件 的 方式 来 增加 这 个 文件 . 如 下 所 示 : 


aardvarkpro ICON aardvarkpro.ico 
#include "wx/msw/wx.rc" 


这 将 包含 一 个 标准 的 manifest 文 件 ,如 果 你 希望 使 用 自己 定义 的 manifest 文 件 ,在 包含 wx.rc 之 前 ， 
你 需要 定义 wxUSE_NO_MANIFEST 宏 ,然后 再 指定 你 自己 的 manifest 文 件 ,如 下 所 示 : 


aardvarkpro ICON aardvarkpro.ico 
#define wxUSE_NO_MANIFEST 1 
#include "wx/msw/wx.rc" 

1 24 "aardvark.manifest" 


你 也 可 以 直接 将 manifest 文 件 放 在 你 的 应 用 程序 目录 中 ,详情 可 参考 WxWidgets 发 行 版 自 带 的 
docs/msw/winxp.txt 文 件 . 


在 Linux 系 统 上 制作 安装 程序 


在 Linux 系 统 ,你 可 以 选用 图 形 界面 的 安装 程序 ,定制 的 shell 脚 本 或 者 某 个 特定 发 行 版 的 软件 包 ， 
比如 RPM 格式 (基于 Red Hat 发 行 版 ) 和 Debian 发 布 包 (基于 Debian 发 行 版 ), 你 甚至 可 以 直接 将 所 
有 需要 的 文件 压缩 成 一 个 包含 路 径 的 压缩 文件 (.tar.gz 或 者 . tarbz2), 安 装 的 时 候 只 需要 保持 路 
径 解 压 这 个 文件 就 可 以 了 . 


Linux 环 境 下 的 图 形 界面 安装 程序 包括 Loki Setup( 免 费 ),Zero G 公 司 的 InstallAnywhere 和 
InstallShield 等 . 


基于 GTK+ 的 wxWidgets 图 形 界面 应 用 程序 是 桌面 不 可 感知 的 : 它 不 依赖 于 GNOME 或 者 KDE, 因 
此 无 论 在 哪 种 桌面 环境 下 它 都 可 以 运行 .大 多 数 KDE 桌 面 的 发 行 版 都 会 包括 GTK+ 的 库 文件 . 然 
而 ,因为 它们 使 用 不 同 的 桌面 风格 ,GTK+ 程 序 在 KDE 桌 面 上 看 上 去 可 能 会 有 些 不 适应 , 某 些 控件 
可 能 超出 边界 ,这 种 情况 下 你 可 以 建议 你 的 用 户 安装 一 个 KDE 下 的 GTK 风 格 的 皮肤 ,比如 GTK- 
Qt( 不 过 ,在 你 把 它 介绍 给 你 的 用 户 之 前 ,最 好 自己 先 测试 一 下 ). 


你 可 能 会 希望 在 桌面 上 安装 一 个 图 标 ,以 便 你 的 用 户 可 以 直接 使 用 它 来 启动 你 的 程序 .要 在 KDE 
桌面 环境 中 增加 一 个 图 标 ,你 需要 拷贝 一 个 合适 的 APP.desktop 文 件 到 
PREFIX/share/applications 文 件 夹 ,其 中 APP 代 表 你 的 应 用 程序 ,PREFIX 则 通常 代表 
/usr/usrlocal 或 者 其 它 定义 在 KDEDIR 环 境 变量 中 的 路 径 . 下 面 演示 了 一 个 叫做 Acme 的 
Desktop 文 件 ,其 中 架设 Acme 被 安装 在 /optAcme 中 . 


[Desktop Entry] 
BinaryPattern=Acme; 
MimeType= 

Name=Acme 
Exec=/opt/Acme/acme 
Icon=/opt/Acme/acme32x32.png 
Type=Application 

Terminal=0 


而 要 在 GNOME 桌 面 上 增加 一 个 图 标 ,语法 和 KDE 中 相似 不 过 放置 的 位 置 应 该 是 ~/.gnome- 
desktop( 只 对 单个 用 户 有 效 ). 更 多 关于 GNOME 和 KDE 桌 面 文件 的 定义 可 以 在 下 面 的 网 址 看 
到 :http: /www.freedesktop.org/wiki/Standards 2fdesktop_2dentry_2dspec. 


如 何 制 作 RPM 包 的 信息 可 以 在 http://www.rpm.org 找 到 ,那里 还 包含 一 个 免费 的 在 线 电子 书 .而 
创建 Debian 包 的 信息 可 以 在 http:/www.debian.org 找 到 .这 俩 中 方法 创建 的 安装 包 可 以 允许 系 
统 进行 依赖 性 检查 ,也 使 得 用 户 可 以 很 容易 的 浏览 软件 包 的 内 容 和 安装 软件 包 . 如 果 需 要 创建 
RPM,.deb 或 者 其 它 格式 发 行 包 的 软件 ,可 以 试 一 下 EPM. 


关于 使 用 shell 脚 本 创建 Linux 的 安装 文件 的 方法 , 随 书 光 瘟 的 examples/chap2O/install 目 录 中 包 
含 了 一 个 用 来 安装 Acme 的 示例 文件 installacme. 这 个 脚本 作 的 事情 包括 安装 整个 程序 并 且 创 建 
一 个 叫做 acme 脚 本 ,这 个 脚本 在 运行 实际 的 可 执行 文件 之 前 会 先 设置 当前 位 置 环 境 变量 .这 样 
作 的 好 处 在 于 你 既 不 需要 将 软件 所 在 的 目录 的 路 径 增 加 到 PATH 环 境 变量 中 ,也 不 需要 将 可 执行 
文件 直接 拷贝 到 系统 路 径 下 就 可 以 执行 .所 有 的 数据 文件 保持 在 可 执行 文件 所 在 的 目录 中 .这 使 
得 扼 载 软件 变 得 容易 .你 当然 也 可 以 选择 让 安装 脚本 将 数据 放置 到 Linux 的 标准 数据 目录 中 . 


在 examples/chap20/install 目 录 中 还 包含 一 个 脚本 叫做 maketarball.sh, 它 演示 了 怎样 创建 一 个 
用 户 发 行 的 tar 格 式 的 压缩 包 ,installacme 脚 本 将 包含 在 这 个 压缩 包 内 以 及 另外 一 个 包含 所 有 数 
据 文 件 的 压缩 包 . 你 可 以 修改 maketarball.sh 以 满足 你 自己 的 需要 . 


Linux 环 境 上 的 动态 链接 库 的 问题 


为 Linux 系 统 上 并 没有 标准 的 GUI 库 , 各 个 发 行 版 按照 自己 的 喜好 来 添加 它 喜 欢 的 库 和 程序 , 因 
此 你 可 能 会 发 现在 某 些 系统 上 ,你 的 应 用 程序 不 能 运行 ,提示 的 原因 是 无 法 找到 动态 链接 库 . 因 
此 ,静态 链接 所 有 需要 的 库 文 件 实在 是 一 个 很 诱 人 的 想法 .但 是 这 样 又 会 导致 别 的 一 些 问题 .虽然 
你 不 应 该 静态 链接 GTK+ 的 那些 库 文 件 ,但 是 静态 链接 wxWidgets 的 库 是 可 行 的 ,你 可 以 在 运行 
configure 脚 本 的 时 候选 择 开 关 --disable- shared 以 达到 这 个 目的 .你 也 可 以 考虑 将 wxWdigets 提 
供 的 那些 动态 链接 库 以 及 所 需要 的 GTK+ 相 关 的 库 和 你 的 应 用 程序 打包 在 一 起 发 布 . 


另外 就 是 不 要 在 太 老 的 linux 发 行 版 ( 太 老 的 那些 动态 链接 库 在 新 版 上 已 经 不 提供 了 ) 或 者 太 新 的 
Linux 发 行 版 (需要 一 些 老 的 发 行 版 上 还 没有 的 库 ) 上 编译 你 的 软件 .同时 考虑 在 给 你 的 链接 器 增 
加 -lsupc++ 选项 ,以 便 你 的 程序 可 以 静态 链接 一 些 基本 的 C++ 的 库 , 而 不 是 需要 完全 的 依赖 动态 
链接 库 , 这 样 作 可 能 会 解决 一 些 潜在 的 问题 (不 过 ,请 注意 静态 链接 GPL 库 时 候 的 版 权 问 题 ). 


最 后 ,如 果 你 想 要 针对 各 个 发 行 版 发 布 不 同 的 软件 包 , 如 果 你 不 想 老 是 重新 启动 电脑 以 切换 到 不 
同 的 Linux, 你 可 以 考虑 使 用 一 个 工具 比如 伟大 的 VMware, 它 可 以 让 你 同时 在 你 的 机 器 上 运行 多 
个 linux 的 发 行 版 . 


在 Mac OSX 上 安装 程序 


的 磁盘 镜像 文件 ,我 们 将 简单 的 介绍 一 下 .Mac OSX 上 没有 安装 程序 制作 工具 这 种 东西 ,你 只 需 
要 将 你 的 文件 夹 拖 到 磁 角 的 合适 的 位 置 就 可 以 了 . 


下 面 我 们 大 概 来 介绍 一 下 Mac 的 软件 包 结 构 ,你 可 以 在 芋 果 公司 的 网 站 
http://developer.apple.com/documentation/MacOSX/Conceptual/SystemOverview/Bundles/c 
hapter_4 section _3.html 找到 更 多 的 信息 . 


一 个 软件 包 包 含 一 个 标准 的 目录 结构 和 一 个 Info.plist 文 件 ,这 个 文件 用 来 描述 软件 包 的 某 些 属 
性 . 


一 个 小 的 软件 包 结 构 如 下 所 示 : 


DialogBlocks.app/ ; top-level directory 


Contents/ 
Info.plist ; the property list file 
MacOS/ 
DialogBlocks ; the executable 
Resources/ 
dialogblocks-app.icns ; the app icon 
dialogblocks-doc.icns ; the document icon(s) 


下 面 是 一 个 用 于 DialogBlocks 软 禁 的 Info.plist 文 件 的 例子 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE plist SYSTEM "file://localhost/System/Library/DTDs/PropertyList.dtd"> 
<plist version="0.9"> 
<dict> 
<key>CFBundleInfoDictionaryVersion</key> 
<string>6.0</string> 
<key>CFBundleIdentifier</key> 
<string>uk.co.anthemion.dialogblocks</string> 
<key>CFBundleDevelopmentRegion</key> 
<string>English</string> 
<key>CFBundleDocumentTypes</key> 
<array> 
<dict> 
<key>CFBundleTypeExtensions</key> 
<array> 
<string>pjd</string> 
</array> 
<key>CFBundleTypeIconFile</key> 
<string>dialogblocks-doc.icns</string> 
<key>CFBundleTypeName</key> 
<string>pjdfile</string> 
<key>CFBundleTypeRole</key> 
<string>Editor</string> 
</dict> 
</array> 
<key>CFBundleExecutable</key> 
<string>DialogBlocks</string> 
<key>CFBundleIconFile</key> 
<string>dialogblocks-app.icns</string> 
<key>CFBundleName</key> 
<string>DialogBlocks</string> 
<key>CFBundlePackageType</key> 
<string>APPL</string> 
<key>CFBundleSignature</key> 
<string>PJDA</string> 
<key>CFBundleVersion</key> 
<string>1.50</string> 
<key>CFBundleShortVersionString</key> 
<string>1.50</string> 
<key>CFBundleGet InfoString</key> 
<string>DialogBlocks version 1.50, (c) 2004 Anthemion Software Ltd.</string> 
<key>CFBundleLongVersionString</key> 
<string>DialogBlocks version 1.50, (c) 2004 Anthemion Software Ltd.</string> 
<key>NSHumanReadableCopyright</key> 
<string>Copyright 2004 Anthemion Software Ltd.</string> 
<key>LSRequiresCarbon</key> 
<true/> 
<key>CSResourcesFileMapped</key> 
<true/> 
</dict> 
</plist> 


程序 使 用 的 图 标 和 支持 的 文档 类 型 是 通过 CFBundlelconFile 和 CFBundleTypelconFile 属 性 指 
定 的 .正如 我 们 在 第 10 章 ," 使 用 图 片 编程 "中 介绍 的 那样 ,如 果 你 主要 实在 Windows 或 Linux 下 编 
程 ,你 可 以 创建 各 种 不 同 大 小 的 (16x16,32x32,48x48 和 128x128) 的 图 标 文 件 .将 其 保存 为 透明 
的 PNG 文 件 ,然后 拷贝 到 Mac 平 台 上 ,在 Finder 中 打开 这 些 文件 ,将 其 拷贝 和 粘 贴 到 茶 果 公司 的 图 
标 编 辑 器 中 ,然后 就 可 以 另存 为 icns 文 件 了 . 


前 面 我 们 介绍 过 的 maketarball.sh 脚 本 也 可 以 用 来 创建 Mac OSX 上 的 磁盘 镜像 文件 .比如 
AcmeApp-1.50.dmg. 它 将 已 经 准备 好 的 AcmeApp.app 包 中 的 目录 结构 拷贝 到 新 的 目录 结构 , 然 
后 拷贝 用 于 Mac OSX 的 可 执行 文件 和 数据 文件 ,然后 再 使 用 下 面 的 代码 创建 一 个 可 以 直接 用 于 
Internet 安 装 的 磁盘 镜像 文件 : 


echo Making a disk image... 

hdiutil create AcmeApp-$VERSION.dmg -volname AcmeApp-$VERSION -type UDIF -megabytes 50 -f 
echo Mounting the disk image... 

MYDEV= hdiutil attach AcmeApp-$VERSION.dmg | tail -n 1 | awk 'f{print $1'}` 

echo Device is $MYDEV 

echo Copying AcmeApp to the disk image... 

ditto --rsrc AcmeApp-$VERSION /Volumes/AcmeApp -$VERSION/AcmeApp -$VERSION 

echo Unmounting the disk image... 

hdiutil detach $MYDEV 

echo Compressing the disk image... 

hdiutil convert AcmeApp-$VERSION.dmg -format UDZO -0 AcmeApp-$VERSION-compressed.dmg 
echo Internet enabling the disk image... 

hdiutil internet-enable AcmeApp-$VERSION-compressed.dmg 

echo Renaming compressed image... 

rm -f AcmeApp-$VERSION. dmg 

mv AcmeApp-$VERSION-compressed.dmg AcmeApp-$VERSION. dmg 


ea ae 


之 后 ,新 创建 的 磁盘 镜像 文件 就 可 以 拷贝 到 你 的 FTP 站 点 或 者 CD-ROM 站 点 . 当 你 的 用 户 在 一 个 
浏览 器 中 点 击 这 个 文件 的 时 候 , 文 件 就 会 被 自动 下 载 , 解 包 ,加 载 成 一 个 虚拟 的 磁盘 ,所 有 这 些 过 
程 都 不 需要 用 户 的 干预 ,然后 就 等 着 用 户 把 整个 软件 包 拖 搜 到 磁 意 的 合适 的 位 置 ,就 可 以 完成 软 
件 的 安装 了 . 





20.10 遵循 用 户 界 面 设 计 规 沁 


学 习 各 个 平台 的 界面 设计 规范 是 一 件 很 值得 一 做 的 事情 .虽然 它们 中 的 绝 大 多 数 差异 都 已 经 被 
wxWidgets 自 动 屏 艾 了 ,不 过 还 是 有 一 些 细节 是 无 法 自动 解决 的 .比如 按钮 的 布局 风格 在 不 同 的 
平台 上 是 不 一 样 的 . 荣 果 的 Mac OSX 操 作 系 统 上 按钮 的 顺序 和 间隔 的 要 求 是 非常 严格 的 .下 面 只 
是 我 们 认为 值得 特别 说 明 的 一 些 方面 ,包括 一 些 平台 相关 的 规则 和 一 些 一 般 的 规则 .另外 你 也 可 
以 通过 多 操作 各 个 平台 上 的 经 典 的 程序 ,并 观察 他 们 外 观 的 不 同 来 帮助 你 设计 你 自己 的 程序 在 
这 些 平台 上 的 外 观 . 


标准 按钮 


在 windows 和 Linux 平 台 上 ,按钮 可 以 被 整体 居中 或 者 右 对 齐 ,通常 的 顺序 是 OK,Cancel 和 Help. 
而 在 Mac OSX 上 ,帮助 按钮 (如 果 使 用 wxID_HELP 会 自动 显示 一 个 问号 标记 ) 通 常 应 该 是 左 对 齐 
的 ,其 它 的 按钮 则 是 右 对 齐 的 ,并 且 最 右边 的 那个 是 默认 按钮 ,也 就 是 说 是 :? 号 ,空格 ,Cancel,OK 
这 样 的 顺序 . 


尽 可 能 使 用 wxWidgets 提 供 的 标准 按钮 标识 符 ( 比 如 wxID_OK, wxID_CLOSE, wxID_APPLY 
等 ), 因 为 在 某 些 平台 上 (尤其 是 wxGTK 平 台 上 ), 这 些 标准 标识 符 会 被 自动 添加 一 些 合适 的 图 形 . 


参考 第 7 章 " 使 用 布局 控件 进行 窗口 布局 "中 的 "平台 相关 布局 "小 节 了 解 wxStdDialogButtonSizer 
类 的 使 用 方法 ,这 个 类 能 够 对 标准 按钮 进行 平台 相关 的 布局 . 


菜单 


避免 出 现 空 的 菜单 条 .小 心 的 给 各 个 菜单 添加 有 意义 的 标签 ,并 且 使 用 "&" 符 号 引导 的 通常 是 标签 
的 第 一 个 字符 的 加 速 键 (比如 &File) 和 快捷 键 (比如 CtrlI+O). 常 用 的 那些 菜单 项 命令 应 该 尽 可 能 
的 提供 ,比如 拷贝 ,粘贴 ,撤消 等 .不 要 有 太 长 或 者 太 短 的 菜单 项 .通常 9 到 10 个 菜单 项 是 一 个 比较 
合理 的 最 大 值 .如 果 确 实 有 很 多 选项 需要 配置 ,可 以 考虑 使 用 一 个 菜单 项 弹出 一 个 对 话 框 进行 这 


些 设 置 . 


和 按钮 的 使 用 一 样 , 尽 可 能 使 用 wxWidgets 提 供 的 标准 的 标识 符 ,尤其 是 
wxID_HELPwxID_PREFERENCES 等 ,在 Mac OSX 平 台 上 ,wxID_HELP 菜 单 将 被 移动 到 应 用 
系统 菜单 中 去 ,你 应 该 注意 这 个 问题 ,以 便 产生 空 的 菜单 条 或 者 连续 两 个 菜单 分 割 条 . 


标 


你 工具 栏 ,frame 窗 口 和 别 的 界面 元 素 上 的 图 标 可 以 给 你 的 应 用 程序 一 个 很 好 的 观感 .忽略 这 一 
点 可 以 让 你 的 应 用 程序 的 界面 效果 大 打折 扣 . 尤其 是 在 MAc OSX 平 台 上 ,这 个 平台 对 于 美学 的 
要 求 是 很 高 的 .你 应 该 尽量 给 每 一 个 项 目 创建 自己 的 图 标 ,或 者 ,一 个 更 简单 的 作法 ,直接 购买 别 
人 设计 好 的 图 标 ,然后 将 那些 非 标准 的 图 标 按照 统一 的 风格 进行 设计 .在 图 标 上 的 付出 将 会 获得 
等 价 的 回报 ,你 的 应 用 程序 将 会 因为 使 用 了 这 些 图 标 而 增光 添彩 ,也 会 给 用 户 留 下 很 强烈 的 印象 . 
你 也 可 以 在 网 上 找到 一 些 图 标 ,比如 ,遵循 L-GPL 协 议 发 布 的 Ximian 图 标 集 : http: 
/Iwww.novell.com/coolsolutions/feature/1637.html . 


字体 和 颜色 


不 要 在 你 的 对 话 框 上 使 用 很 多 中 字体 和 颜色 ,这 除了 导致 你 的 界面 看 上 去 花 里 胡 喻 以 外 ,还 使 得 
wxWidgets 很 难 去 进行 针对 各 个 平台 的 一 些 外 观 调整 ,以 便 给 出 你 的 应 用 程序 以 本 地 观感 .不 过 ， 
这 并 不 防 碍 你 给 你 的 用 户 增加 更 改 上 默认 字体 的 选项 ,以 便 他 们 可 以 改变 那些 包含 很 多 纹理 信息 
的 对 话 框 的 外 观 ,比如 用 作 报 告 的 对 话 框 .对 于 颜色 的 使 用 要 遵循 那个 平台 的 规范 .对 于 
wxWidgets 提 供 的 对 话 框 ,wxWidgets 可 以 自己 作 一 些 平台 适应 工作 , 但 是 对 于 你 自 定义 的 对 话 
框 , 有 些 则 需要 你 自己 去 注意 这 个 问题 . 


应 用 程序 中 止 时 的 行为 


在 大 多 数 平 台 上 ,没有 使 用 MDI 界 面 或 者 将 类 似 界 面 的 基于 文档 的 应 用 程序 将 在 每 个 rame 窗 口 
中 显示 一 个 文档 . 当 最 后 一 个 文档 被 关闭 的 时 候 应 用 程序 就 将 退出 .但 是 在 Mac OSX 平 台 上 , 正 
如 我 们 在 第 19 章 "使 用 文档 和 视图 框架 "中 介绍 的 那样 ,用 户 并 不 期 待 这 时 候 整 个 应 用 程序 退出 ， 
应 用 程序 应 该 还 有 一 个 菜单 显示 在 系统 菜单 条 上 ,以 便 用 户 可 以 通过 它 打 开 或 者 创建 新 的 文档 
或 者 关闭 应 用 程序 .这 可 以 通过 创建 一 个 不 可 见 的 frame 主 窗口 的 方法 来 实现 ,可 能 需要 你 增加 


在 谋 入 式 开发 系统 中 (比如 Pocket PC), 应 用 程序 在 主 窗口 被 关闭 的 时 候 仍然 停留 在 内 存 中 ,用 
户 通常 没有 办 法 让 他 们 退出 .你 可 以 选择 是 否 遵守 这 个 规则 还 是 允许 用 户 退 出 应 用 程序 以 便 给 
别 的 程序 腾 出 内 存 .在 Pocket PC 上 ,wxWidgets 也 会 设置 标准 的 快捷 键 Ctrl+Q 用 来 退出 应 用 程 
序 ,这 个 快捷 键 的 默认 义理 动作 是 发 送 wxID_EXIT 命 令 事 件 


进一步 阅读 


下 面 列 出 了 wxWidgets 支 持 的 各 个 主要 平台 上 的 用 户 界面 设计 规范 ,以 及 一 些 一 般 性 UI 设计 建 
议 的 书籍 : 


。 荣 果 用 户 界面 设计 规范 : 
http://developer.apple.com/documentation/UserExperience/Conceptual/OSXHIGuideline 
s/index.html 

e Mac OSX 和 Windows 用 户 界 面 的 关键 差异 : 
http://developer.apple.com/ue/switch/windows.html 

。 微软 官方 用 户 界面 设计 规范 : http://msdn.microsoft.com/library/default.asp? 
url=/library/enus/dnwue/html/welcome.asp 

e GNOME 用户 界面 设计 规范 : http://developer.gnome.org/projects/gup/hig 

e GUI Bloopers: 软件 开发 和 和 Web 设计 中 要 做 和 不 要 作 的 事 , 作者 :Jeff Johnson (Academic 
Press). ISBN 1-55860-582-7 

。 程序 员 用 户 界 面 设计 , 作者 : Joel Spolsky (Apress). ISBN 1-893115-94-1 

e 软件 可 用 性 : 以 可 用 性 为 核心 进行 软件 设计 和 建 模 (A Practical Guide to the Models and 
Methods of Usage-Centered Design), 作者 :Larry L. Constantine and Lucy A.D. 
Lockwood (ACM Press). ISBN 0-201-92478-1 


20.11 全 书 小 结 


本 章 我 们 介绍 了 完善 你 的 程序 相关 的 各 种 主题 ,演示 了 一 些 弥 补 wxWidgets 不 足 之 处 的 代码 .最 
后 我 们 介绍 了 一 些 用 户 界面 设计 的 有 益 提示 ,介绍 了 一 些 更 进一步 介绍 Ul 规范 的 书籍 . 


我 们 希望 通过 这 些 书 籍 的 阅读 ,能 够 让 你 更 加 认同 我 们 的 工作 ,更 加 认同 wxWidgets, 它 是 一 个 非 
常 强大 的 工具 集 , 它 可 以 给 予 你 的 东西 包括 : 


你 的 应 用 程序 将 拥有 本 地 观感 

大 量 的 类 控件 ,包括 各 种 简单 和 复杂 的 窗口 控件 , 轻 量 级 的 HTML 支 持 , 向 导 , 联 机 帮助 ,多 线 
程 ,进程 间 通 信 , 流 及 虚拟 文件 系统 等 等 ,将 让 你 开发 出 更 加 稳健 的 产品 级 的 程序 ,并 且 让 你 
享受 开发 的 过 程 . 


你 可 以 很 容易 的 将 你 的 代码 移植 到 别 的 你 正 打 算 移 植 的 平台 ,比如 Pocket PC 和 Mac OS X, 
以 便 为 它 赢 得 更 大 的 市 场 . 

通过 使 用 快速 开发 工具 比如 DialogBlocks, 以 及 强大 的 布局 控件 机 制 ,你 可 以 很 快 的 创建 出 
复杂 而 优雅 的 ,可 伸缩 的 并 且 是 可 移植 的 对 话 框 和 窗口 . 

wxWidgets 是 开放 源 代 码 的 ,你 可 以 更 改 它 的 代码 或 者 理解 它 到 底 是 怎样 工作 的 . 

你 将 从 wxWidgets 庞 大 的 社区 支持 中 受益 ,你 的 问题 将 很 快 被 答复 ,你 还 可 以 使 用 很 多 第 三 
方 的 控件 和 工具 包 ( 参 考 附 录 E) 


我 们 非常 希望 你 能 够 享受 阅读 这 本 书 的 过 程 ,并 且 在 浏览 了 光盘 中 的 例子 和 工具 之 后 ,愿意 马上 
开始 将 你 学 到 的 这 些 知识 应 用 到 你 的 跋 平台 程序 中 去 . 祝 你 好 运 ,我 们 期 待 很 快 能 够 在 
wxWidgets 的 邮件 列表 或 者 论坛 上 看 到 你 的 身影 . 


